UNISYS 




BIOS 
Multimode 
Terminal 
Program 
(MTP) 



Programming 
Reference Manual 



Copyright © 1987. Unisys Corporation, 
All Rights Reserved 



Relative to April 1C87 

Release Level 5.0 

Priced Item 1182649 



UNISYS BIOS 

Multimode 
Terminal 
Program 
(MTP) 

Programming 
Reference Manual 



Copyright © 1987, Unisys Corporation, 
All Rights Reserved 



Relative to April 1987 

Release Level 5.0 



Priced Item 



1182649 



Unisys believes that the software described in this manual is 
accurate, and much care has been taken in its preparationo - 

The customer's attention is drawn to the provisions of the Trade 
Practices Act 1974 (as amended) (*the Act') which Imply conditions 
and warranties into certain contracts for the supply of goods and 
serviceSo Where such conditions and warranties are implied 
Unisys liability shall be limited (subject to the provision of 
Section 68A of the Act) to the replacement or repair of the goods 
or the supply of equivalent goods. 

The customer should exercise care to assure that use of this manual 
and the software will be in full compliance with the laws, rules and 
regulations of the jurisdiction in which It is used. 

The information contained herein Is subject to change o Revisions 
may be issued from time to time to advise of changes and/or 
additions. 



Correspondence regarding this publication should be forwarded, using the 
Product Improvement Card at the back of this manual, or remarks may be 
addressed directly to Unisys Corporation, Corporate Product Information 
East, Building C, Township Line and Union Meeting Road, Blue Ball, PA 
19424 U S America. 
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Overview 

Introduction 

The Multimode Terminal Program (MTP) allows a BTOS 
workstation to be used as an intelligent terminal that can 
communicate with host computers. MTP provides 
text'based and forms-based data entry, a large display 
memory, local text editing, and a variety of commands for 
controlling MTP operation. MTP uses the processing power 
of the workstation to access printers and disk files and to 
offer CCITT X.25 protocol for communication over public 
data networks. 

MTP can be configured with commands sent over the 
communications channels from the host computer or read 
from local disk files. These commands allow the user to 
develop custom MTP forms and operations for specific 
applications. 

Documentation Overview 

The Multimode Terminal Program (MTP) Programming 
Reference Manual provides detailed information on 
controlling MTP functions and configuring MTP for specific 
applications. This manual is intended for users who write 
host computer programs for MTP applications and/or create 
special MTP configurations. It assumes that users are 
familiar with the Multimode Terminal Program (MTP) 
Operations Guide, 

The Multimode Terminal Program (MTP) Operations Guide 
provides descriptions of MTP's screen and keyboard 
functions as well as basic operating instructions. 

Note: The Multimode Terminal Program User's Guide should be read be- 
fore the Multimode Terminal Program (MTP) Programming Reference 
Manual. 

The "Multimode Terminal Program X.25 Communications 
Options" section of the BTOS X.25 Gateway Operations 
and Programming Guide describes MTP use of the BTOS 
X.25 Network Gateway for communication over public data 
networks. 
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Concepts 

Display Memory 

Data can be transmitted to MTP in three ways. 

□ The user can enter data from the MTP keyboard. 

□ The host computer can send data over the 
communications channel. 

□ MTP can read data from files. 

MTP stores all data for display in a large memory area, 
called display memory, that can contain more than 65,000 
characters of data. Its actual size depends on the amount of 
memory available on a workstation when MTP is activated. 

Video Display Screen 

MTP displays both MTP status information and data from 
the display window on the workstation's video display 
screen - 

The top four lines of the display screen are called the status 
frame and contain status information. Status information 
includes the date and time, MTP operational status, file and 
printer status, communications channel status, and status 
messages. 

The remainder of the display screen, the window, is a visible 
representation of a portion of the data maintained in display 
memory. As the user enters data, display memory moves 
through the window so the most current data are always 
visible. In addition, the user can change the portion of 
display memory visible within the window to show any 
previously entered data. 

MTP can display data in lines of 80 characters on all BTOS 
workstations. If, however, the workstation has a 
1 32-column mode, MTP can display data in lines of either 
80 or 132 characters per line. If the user tries to select 
1 32-column mode on a workstation without that capability, 
the display will remain in 80-column mode. 

Display Types 

The display types MTP has to present are text display and 

format display. 
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Text Display 

Text Display presents display memory in a freeform manner. 
The data in display memory are displayed as lines, much like 
a typed page. 

Text display allows a user to enter and/or edit data in 
display memory from the keyboard before transmitting the 
data or enter and/or edit data while transmitting the data to 
the host computer. 

This display type is used for document preparation and 
text-based data entry. It supports high-level text editing 
capabilities available from the keyboard. 

Format Display 

Format display presents diisplay memory in a fixed-format 
manner and restricts how and where the user can enter 
data. The exact presentation of display memory is 
controlled by an application-specific form. Created by a 
systems analyst, forms are stored either at the host 
computer or in a file. 

Format display arranges display memory Into areas called 
fields according to the instructions contained in the form. 

Protected fields display preentered, constant information. 

Unprotected fields receive data (usually requested by an 
associated protected field). An unprotected field can restrict 
the type of data the usier can enter into it. 

Each field has attributes that specify its display and input 
characteristics. 

Display characteristics specify how the field is displayed on 
the video display. (For example, the reverse video attribute! 
brightly highlights a field.) 

Input characteristics specify the type of data that the user 
can enter in the field. Verification that the data are of the 
required input characteristic can be done as each character 
of data is entered or as the user leaves the field. MTP does 
this verification, through the field verification program (see 
the "Field Verification Program") or by the host computer, 
depending on how the form is defined. 

The user can edit data entered in unprotected fields and 
move between these fields with capabilities available from 
the keyboard. 
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Communications 

MTP communicates with a host computer using CCITT X.25 
protocol over public data networks through the Burroughs 
X.25 Network Gateway installed at a master or standalone 
workstation. 

Transmission Types 

MTP supports block transmission and conversational 
transmission for sending data to a host computer. 

Block Transmission 

In block transmission, each character is entered into display 
memory as the user types it but is not transmitted to the 
host computer. The user can edit data In display memory 
before sending data to the host. The user can transmit all of 
display memory or use keyboard commands to select areas 
of display memory to be transmitted to the host computer. 

Conversational Transmission 

In conversational transmission, each character is transmitted 
to the host computer as the user enters it. Conversational 
transmission is intended for applications where local editing 
of user's input is not required. The two modes of 
conversational transmission are half-duplex mode and 
full-duplex mode. 

In half-duplex mode, each character is entered into display 
memory as it is transmitted to the host. 

In full-duplex mode, each character is transmitted to the 
host, but is not entered into display memory. The host 
computer must echo the character (return it over the 
communications channel) for it to be entered into display 
memory. The host computer determines if it will echo 
characters. If the host computer does not echo the 
character, the window of the video display remains blank 
while the user enters data through the keyboard. 

Files 

MTP can simultaneously access up to four files for entering 
and transmitting data. 
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Data from an input file can be entered into display memory 
or transmitted directly to the host computer. 

Data from display memory can be stored in an output file. 

Data transmitted to MTP by the host computer can be 
stored in a recording file. A recording file does not affect 
other MTP operations. 

Data from display memory can be transmitted to local 
printers directly or by the printer spooler. The printer file is 
the specification of the printer that is to print the data. The 
printer file can be any printer or spooler byte stream or any 
conventional disk file. 

Keyboard 

MTP uses standard workstation keyboards for entering and 
editing data as well as for activating advanced operations. 
The functions assigned to the keys by MTP are designed for 
terminal emulation and in many cases from keyboard 
functions used with other workstation programs. (For further 
information, refer to the BTOS Multimode Terminal Program 
(MTP) Operations Guide,) 

There are 1 6 programmable keys on the MTP keyboard: 

□ GO 

□ HELP 

□ TAB 

o RETURN or NEXT 

(both keys always have the same function) 

□ FINISH 

□ 1/2 / 1/4 

□ The functions keys, f1 through flO 

These programmable keys can be used in conjunction with 
the SHIFT and CODE keys. For example, the GO key can be 

used alone or depressed simultaneously with the SHIFT key 
or with the CODE key. In this way, these keys and their 
various combinations enable the user to generate 47 
different functions. (SHIFT TAB is not a valid combination.) 

The user can configure these keys to perform 
application-specific functions with MTP commands. (See 
Section 3, the "Programmable Strings" subsection.) 
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Escape Sequences 

MTP communication, editing, and forms processing 
functions can be controlled by commands. A command 
consists of a series of characters called an escape 
sequence. An escape sequence consists of an escape 
character, followed by one or more characters. The escape 
character indicates that the following character or group of 
characters is to be considered a command instead of data. 
The rest of the sequence represents the function to be 
performed. 

Escape sequences are transmitted to MTP over the 
communications channel by the host, read from a command 
file, or entered when the user presses a programmable key. 

Read Section 3 for a more detailed description of escape 
sequences. 

Configurability 

MTP can be configured for specific applications in one of 
two methods. 

One method is the use of command files, which are files 
containing escape sequences that define the functions of 
programmable keyboard keys, select operational modes, or 
define application-specific forms. MTP has a standard 
command file that configures MTP as a general purpose 
terminal. This command file can be altered to adapt MTP to 
specific applications. 

The other method is the transmission of escape sequences 
by host computer to MTP over the communications channel. 

Field Verification Program 

The field verification program is a series of escape 
sequences loaded from the host computer or a command 
file and stored in display memory. Portions of the field 
verification program can be associated with programmable 
keys or fields in forms. 

The field verification program provides the ability to 
construct an interpretive program, based on escape 
sequences, to adapt MTP to specific user applications. 
Although, as the name implies, the primary use of the 
program is input verification, it can also be used for complex 
functions such as arithmetic calculations and interpretation 
of host computer data. 
1182649 
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Escape Sequences 

MTP functions such as cursor positioning, transmission type 
selection, and field definition can be controlled by escape 
sequences. Escape sequences consist of the escape 
character (IBh; this character is represented by ESC in this 
manual) followed by one or more characters. Escape 
sequences can be sent to MTP by the host over the 
communications channel, read from a command file, or 
entered directly from the keyboard. 

Escape Sequence Formats 

MTP recognizes three forms of escape sequences: 

ESC X ESC:/7 x ESC:x 

ESC X is used for escape sequences without numeric 
arguments, x can be any valid ASCII character. Examples of 
this format are ESC A, ESC 2, and ESC &. 

ESC:a7 X is used for escape sequences requiring a numeric 
argument where: 

A) represents a series of decimal digits from zero to 
4,294,967,295. Escape sequences requiring an 
argument of either zero or 1 treat non-zero values as 1 . 
That is, only the least significant bit is examined. 

X is the ASCII character designating the function to be 
performed. 

Examples of this format are ESC: 10 F and ESC:5 g. 

ESC:x is used for escape sequences that manipulate display 
memory using the current cursor position, x is the ASCII 
character designating the function to be performed. 

Examples of this format are ESC:F and ESC:g. 

Data and escape sequences can be interspersed throughout 
the input to MTP. For example, the following sequence 
moves the cursor to row 8, column 6, displays the 
character @, and then moves the cursor back to line 1 : 

ESC:8 B ESC:6 C @ ESC:1 B 

Note: Escape sequences are shown in this manual with spaces 
between the various elements of the sequence for clarity only. 
In actual use, spaces do not appear in escape sequences. 
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Some escape sequences have text appended to them. This 
text must be delimited (begun and ended) by a character 
that does not appear in the text. Throughout this manual, 
the quotation mark character (") is used to signify a generic 
delimiter. In those few cases where a particular delimiter is 
required, that character is shown. 

Escape Sequences from the Host Computer 

Escape sequences are transmitted over the communications 
channel to MTP as a sequence of characters. For example, 
to set the video display width to 80 columns, the sequence 
ESC:80 z would be transmitted: 

IB 3A 38 30 7A 

ESC : 8 0 z 



Escape Sequences from a Command File 

Escape sequences read from a command file are interpreted 
as if they were received over the communications channel. 
A command file is read and interpreted as escape 
sequences when MTP executes the ESC y escape 
sequence. 

Escape Sequences from the Keyboard 

Escape sequences are entered from the keyboard as 
character strings (for example, ESC:80 z as shown above}. 
The escape character is entered by pressing the CODE and 
c key combination (CODE-c). To enter the escape character 
(ESC) to perform a function, press CODE-c and then the 
escape sequence. (For example, CODE-I executes a tab.) 

To enter the escape character on the screen without 
interpretation (to perform no function), press CODE-a and 
then CODE-c. 
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Field Verification Program 

The ESC text escape sequence allows escape sequences 
read fronn a command file or received from the host 
computer to be stored internally to MTP as an interpretive 
program called the field verification program (see the "Field 
Verification Program" section below). Portions of the field 
verification program can be associated with programmable 
keys or with certain unprotected fields when MTP is in 
format display. Thus, MTP can be configured to execute a 
series of escape sequences for application-specific 
functions. 



Operation of Escape Sequences 

Certain escape sequences operate differently depending on 
the current state (text or format display) of MTP. For 
example, the ESC p escape sequence is invalid in format 
display. 

Definitions 

The remainder of this section defines the escape sequences 
recognized by MTP. 

Some of the more common escape sequences are 
associated with individual keys to simplify user input. In the 
following tables, the key column lists individual keys. or key 
combinations on the keyboard that, when pressed, cause 
the escape sequence to be executed. 

When the operation of an escape sequence differs for text 
and format display, the descriptions following the tables 
explain the differences. 

The escape sequences in this section are ordered first by 
uppercase letters, then by lowercase letters, by numbers, 
by special characters according to their ASCII 
representation, and, finally, by variables. 
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Functional Groups 

Escape sequences are grouped within this section according 
to the type of function performed: 

□ Cursor control 
o Text scrolling 

□ Tab and margin control 

□ Editing 

□ Field definition 

□ Look-up tables 
D Range tables 

o Field verification 

□ Programmable strings 

□ Communications establishment and monitoring 

□ X.25 Network Gateway communications 
o Transmission type 

a Information transfer 

a File and printer management 

□ Display memory management 

□ Sorting 

□ Miscellaneous 

Cursor ContKil 

Escape sequences for cursor control move the cursor within 
display memory. The cursor can move right or left within 
the limits of the video display (either 80 or 132 columns). 
Cursor movement up or down within the window does not 
affect display memory. Any cursor movement that would 
exceed the vertical limits of the window causes display 
memory within the window to scroll up or down. 

Escape sequences that move the cursor outside the limits of 
display memory, such as attempting to move the cursor up 
when It is already on the top line of display memory, are 
invalid. Invalid escape sequences cause the workstation to 
beep and are ignored. 
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Cursor movement does not affect the content of display 
memory. 

Escape Sequences 

The escape sequences for cursor control are summarized in 
Table 3-1 . A more detailed discussion follows the table. 



Table 3-1 Escape Sequences for Cursor Control 



Escape 
Sequence 


Key 


Description 


ESC A 


T 


Moves the cursor up 


ESC B 


I 


Moves the cursor down 


ESCC 




Moves the cursor right 


ESC D 


i 


Moves the cursor left 


ESCF 


C0DE4 


Text display: moves the 
cursor to the home down 
position 

Format display, moves the 
cursor to the first 
unprotected field 


ESCG 


CODE-e- 


Text display: moves the 
cursor to the home left 
position 

Format display: moves the 
cursor to the first column of 
the current field 


ESC H 


CODE-T 


Text display: moves the 
cursor to the home position 

Format display: moves the 
cursor to the first position of 
the first unprotected field 


ESC a 


None 


Requests the cursor position 
be transmitted over the 
communications channel 
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Table 3-1 Escape Sequences for Cursor Control (Cont'd) 



Escape 
Sequence 



Key 



Description 



ESC n 



CODE- 



None 
None 

None 



Text display: moves the 
cursor to the home right 
position 

Format display: moves the 
cursor to the last nonblank 
column of the current field 

Moves the cursor to line n 

Moves the cursor to column 
n of the current line 

Text display, is invalid 

Format display: moves the 
cursor to unprotected field a? 



ESC:/7 B 
ESC:a7 C 

ESC.Y? 0 
ESC A []) 

Moves the cursor up one line without altering the cursor's 
column position. If the cursor is at the top of the window, 
display memory is scrolled down one line. If the cursor is at 
the top of display memory, the workstation beeps. 



ESC B (1) 

Moves the cursor down one line without altering the 
cursor's position in the line. If the cursor is on the last line 
of the window, display memory is scrolled up one line. If the 
cursor is on the last line of display memory, the workstation 
beeps. 



ESC CM 

Moves the cursor one column to the right. The cursor can 
be moved until the right edge of the video display is reached 
{column 79 or column 131, depending on the type of 
workstation and the option chosen); when this happens, the 
workstation beeps. The cursor can be moved past a right 
margin if one is set. 
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ESC D (♦-.) 

Moves the cursor one column to the left. The cursor can be 
moved until the left edge of the video display is reached 
(column zero); when this happens, the workstation beeps. 

ESC F (CODE-i) 

Text display: moves the cursor to the last nonblank text 
position in display memory. This position is referred to as 
home down and is useful when adding new text at the end 
of a document. 

Format display: moves the cursor to the next unprotected field. 
ESC G (CODE.4-) 

Text display: moves the cursor to column zero of the current 
line, referred to as home left. 

Format display: moves the cursor to the first position of the 
current field. 



ESCH(CODE-T) 

Text display: moves the cursor to column zero of the 
topmost line of display memory, referred to as the home 
position. Display memory is scrolled down if necessary. If 
the cursor is already at this position, the workstation beeps. 

Format display: moves the cursor to the first position of the 
first unprotected field. If the cursor is already at this 
position, the workstation beeps. 

ESC a 

Requests the cursor position be transmitted over the 
communications channel. The cursor position is transmitted 
as follows: 



ESC:m B ESC:/? C 

where m is the number of the line containing the cursor and 
n is the number of the column containing the cursor. 
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For example, if the cursor is at the home position when ESC 
a is received, the sequence 

ESCiOOO B ESC:000 C 

is transmitted. 

The characters returned in response to the ESC a escape 
sequence are always transmitted over the communications 
channel even if the escape sequence is entered from a file 
or entered from a keyboard. 

ESC n (CODE-^) 

Text display: moves the cursor right to the last nonblank 
column of the current line, referred to as the home right 
position. If the last column (79 or 131) is not blank, that is, 
the entire line contains data, then the cursor is moved to the 
last column. 

Format display, moves the cursor right to the last nonblank 
position of the current field. If the field is completely filled in, 
then the cursor is moved to the last position in the current field. 

ESC:/7 B 

Moves the cursor to line /7. The horizontal position (column) 
of the cursor is not affected. 

ESC:n C 

Moves the cursor to column n of the current line. The 
vertical position (line) of the cursor is not affected. 

ESC:/7 0 

Text display: \s invalid. 

Format display: moves the cursor to unprotected field n. The 
workstation beeps if the field is not defined. 
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Text Scrolling 

Escape sequences for text scrolling move the lines visible in 
the window of the video display up or down. 

Escape sequences that would cause the cursor to scroll 
outside the limits of display memory are invalid. Invalid 
escape sequences cause the workstation to beep and the 
escape sequence to be ignored. 



Escape Sequences 

The escape sequences for text scrolling are summarized in 
Table 3-2. A more detailed discussion follows the table. 



Table 3-2 Escape Sequences For Text Scrolling 



Escape 
Sequence 

ESC S 



ESCT 
ESCU 
ESC V 



Key 

SCROLL UP 
SCROLL DOWN 
NEXT PAGE 
PREV PAGE 



Description 

Scrolls display memory 
up one line 

Scrolls display memory 
down one line 

Scrolls display memory 
to next page 

Scrolls display memory 
to previous page 



ESC S (SCROLL UP) 

Scrolls the display memory shown in the window up one 
line. The column position of the cursor is not affected. 



ESC T (SCROLL DOWN) 

Scrolls the display memory shown in the window down one 
line. The column position of the cursor is not affected. 
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ESC U (NEXT PAGE) 

Scrolls up the display memory shown in the window so that 
the bottom three lines of the scrolled text are redisplayed as 
the top three lines of the new page. 

ESC V (PREV PAGE) 

Scrolls down the display memory shown in the window so 
that the top three lines of the scrolled text are redisplayed 
as the bottom three lines of the new page. 



Tab and IVIargin Control 

Some escape sequences for tab and margin control change 
the tab stops and right margin within display memory, while 
others move the cursor between tab stops. 

Text Display 

When MTP is first invoked, tab stops and margins are 
automatically set by MTP. Tab stops are set at column zero 
and at every eighth column thereafter; that is, 0, 8, 1 6, 24, 
and so forth, the right margin is set at the right edge of the 
video display (column 79 or 131, depending on the size of 
the video display). The feft margin is permanently set at the 
left edge of the video display (colgrnn zero) and cannot be 
changed. 

In text display, the escape sequence for moving between 
tab stops moves the cursor to the next tab stop by 
inserting bjanks between the preyiPMS cursor position and 
the tab stop. This mepns t^bs are not rnaintained in fiisplay 
memory; that is, inserting tpxt before the tab stop does not 
move text to the next tab stop, ejianging the t^b J§^ttj^gs 
affects only the text ent^red pftpr thP Ph^^ 

Text is entered into display m^mpry until the right margin iis 
reached. If more charactqr^ are inserted, th§ l^st vyprd on 
the line is wrapped to the next line pf display mernory. 
Changing the right margin effects pnly the text entered pfter 
the margin is changed. 
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Format Display 

Tab stops and the right margin are not used in format 
display. However, the escape sequences for moving the 
cursor between tab stops can be used for moving the 
cursor between unprotected fields. 

Escape Sequences 

The escape sequences for tabs and margins are summarized 
in Table 3-3. A more detailed discussion follows the table. 

Table 3-3 Escape Sequences for Tab and Margin Control 
Escape 

Sequence Key Description 

ESC I TAB Text display: moves the 

cursor to the next tab stop 
Format display: moves the 
cursor to the beginning of the 
next unprotected field 

ESC i CODE-TAB Text display: moves the 

cursor to the previous tab stop 
Format display: moves the 
cursor to the first character 
position of the current 
unprotected field or the first 
position of the previous 
unprotected field 

Text display: sets a tab stop 
Format display: is invalid 

Text display: removes a tab 
stop 

Format display: is invalid 

Text display: removes all tab 
stops 

Format display: is invalid 

Text display: sets the right 
margin 

Format display: is invalid 



ESC 1 CODE-e 

ESC 2 CODE-f 

ESC 3 CODE-g 

ESC 5 CODE-i 
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ESC i (TAB) 

Text display: moves the cursor to the next tab stop. If no 
tabs exist between the cursor and the right niargin, the 
cursor is positioned at the tab stop closest to the left 
margin of the next line. 

Format display: Moves the cursor to the beginning of the 
next field. If the cursor is already positioned in the last field, 
the cursor is positioned to the first field in the form. 

The field verification program label (as addressed by the 
field index) is executed if bit 1 of the secondary attribute is 
set (see the "Field Definition" subsection). 

ESC i (CODE^TAB) 

Text display: moves the cursor back to the previous tab 
stop. If there are no tab stops set, the cursor moves to the 
tab stop closest to the right margin on the previous line. 

Format display: moves the cursor to the first character 
position of the current field if the cursor is elsewhere in the 
field. Otherwise, the cursor moves to the first character 
position of the previous field. 

The field verification program label (as addressed by the 
field index) is executed if bit 1 of the secondary attribute is 
set (see the "Field Definition" subsection). 

ESC 1 (CQQM) 

Text display: sets a t^b stop at the cursor position. 
Format display: is invalid. 

ESC 2 (CODE-f) 

Text display: removes the tab stop at the cursor positipn, if 
one was previously j$et. 

Format display: is invalid. 
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ESC 3 (CODE-g) 

Text display: removes all tab stops within display memory at 
the cursor position. Only text that is subsequently entered is 
affected; existing text retains the previous spacing. If no tab 
stops are set, the ESC?3 escape sequences moves the 
cursor to the right margin and the workstation beeps. 

Format display: is invalid. 



ESC 5 (CODE-i) 

Text display: sets the right margin at the cursor position. 
Only escape sequences transmitted over the 
communications line can enter data past the right margin. 
Only text that is subsequently entered is affected; existing 
text retains the previous spacing. 

Format display: is invalid. 

Editing 

Escape sequences for editing allow the editing of text within 
display memory. 

Use block transmission when you are extensively editing 
text with MTP. 

Escape Sequences 

The escape sequences for editing are summarized in Table 
3-4. A more detailed discussion follows the table. 
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Table 3-4 Escape Sequences for Editing 



Escape 
Sequence 



ESC E 



ESC J 



ESC K 



ESCM 



ESC N 
ESCO 



Key 

RETURN or 
NEXT 

CODE-MARK 



None 



None 



SHIFT-DELETE 



OVERTYPE 
(LED off) 

DELETE 



Description 

Inserts a line terminator 
in the current line 

Text display: cancels a 
selection 

Format display: is invalid 

Text display: deletes to 
the end of display 
memory 

Format display: is invalid 

Text display: deletes to 
the end of the line 

Format display: deletes 
to the end of the 
unprotected field 

Text display: deletes the 
current line 

Format display: deletes 
the content of the 
current unprotected field 

Enters insert mode 



Text display: deletes 
the current character 

Format display: 
deletes the current 
character in an 
unprotected field 



ESC R 



OVERTYPE Enters overtype mode 
(LED on) 
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Table 3-4 Escape Sequences for Editing (Cont'd) 



Escape 
Sequence 

ESCf 



Key 

CODE-BOUND 



Description 

Text display: ends a 
column selection 



Format display: is 
invalid 



ESC I 



CODE-DELETE 



Text display: deletes a 
selection 



ESC p 



MARK 



Format display: is 
invalid 

Text display: begins a 
text or column 



ESCq 



BOUND 



Format display: is 
invalid 

Text display: ends a 
text selection 



ESCr 



MOVE 



Format display: is 
invalid 

Text display: moves a 
selection 



ESC s 



COPY 



Format display: is 
invalid 

Text display: copies a 
selection 



ESCO 
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CODE-d 



Format display: is 
invalid 

Text display clears the 
content of display 
memory 

Format display: clears 
the content of all 
unprotected fields 
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RETURN or NEXT 

Inserts a line terminator in the current line. 
ESC E (CODE-MARK) 

Text display: cancels the current selection. The content of 
display memory is not affected. 

Format display: is invalid. 
ESC J 

Text display: deletes the content of display memory from the 
cursor position to the end of display memory. The cursor 
position is not affected. 

Format display: is invalid. 
ESC K 

Text display: deletes the content of display memory from the 
cursor position to the end of the current line. The cursor 
position is not affected. 

Format display: deletes the content of the current 
unprotected field from the cursor position to the end of the 
field. If the cursor is not currently within a field, the "Cursor 
not in field" message is displayed in the status frame and 
the workstation beeps. 

ESC M (SHIFT-DELETE) 

Text display: deletes the entire line containing the cursor. 
Lines below the current cursor position are moved up to 
replace the deleted line. 

Format display: deletes the content of the current 
unprotected field. If the cursor is not currently within a field, 
the "Cursor not in field" message 1$ displayed in the status 
frame and the workstation bqeps. 

ESC N (OVERTYPE-LED off) 

Enters insert mode, which inserts new data at the cursor 
position. Characters on the line at and to the right of the 
cursor position shift to the right to make room for the new 
characters being entered. Text is not otherwise affected by 
the insert mode. (Overtype mode is used to change existing 
text.) 

The LED on the OVERTYPE key is off. 
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The LED on the OVERTYPE key is on. 

Text display: automatically wraps the line to the next line one 
word at a time if the line extends past the right margin. 

Format display: displays the "Field full" message and rejects 
further inputs if the insertion would cause characters to 
extend past the end of the field. 

ESC 0 (DELETE) 

Text display: deletes the character at the cursor position. 
Characters to the right of the cursor position shift left to 
replace the deleted character. If the line does not end with a 
line terminator (if it continues or wraps around to the next 
line) and there is enough room, a word from the next line 
moves up. 

Format display: deletes the character at the cursor position if 
the cursor is currently in an unprotected field. Characters to 
the right of the cursor shift left to replace the deleted character. 

ESC R (OVERTYPE-LED on) 

Enters overtype mode, which causes existing characters to 
be replaced with new characters beginning at the cursor 
position. (Insert mode is used to enter new characters 
without affecting existing text.) 

ESC f (CODE-BOUND) 

Text display: ends the column selection at the cursor 
position. The cursor position must be to the right and at 
least one line down from the beginning of the selection, 
thereby forming a rectangle. 

A text selection is ended with ESC q (or BOUND). If the 
selection is not ended with one of these two escape 
sequences (or keys) and any operation other than scrolling is 
performed, MTP automatically enters text selection and 
ends the selection at the end of the line. 

Format display: is invalid. 
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ESC I (CODE-DELETE) 

Text display, deletes both text and column selections. The 
resulting blank space is replaced by the lines of text to the 
right of and/or below the deleted selection. 

Format display: is invalid. 
ESC p (MARK) 

Text display: begins a text or column selection from the 
current cursor position. The marked area, called a selection, 
is highlighted in the window in reverse video. The selection 
can be transmitted, moved, copied, deleted, sorted (column 
selection only), or printed. 

End text selection by positioning the cursor at the end of 
the selection and sending the ESC q escape sequence (or 
pressing BOUND). End a column selection by positioning the 
cursor at the end of the selection and sending the ESC f 
escape sequence (or pressing CODE-BOUND). If the 
selection is not ended with one of these two escape 
sequences (or keys) and any operation other than scrolling is 
performed, MTP automatically enters text selection and 
ends the selection at the end of the line. 

Format display: is invalid. 
ESC q (BaUI\f 0) 

Text display: ends a text selection. A column selection is 
ended with ESC f (or CODE-BOUND). If the selection is not 
ended with one of these two escape sequences (or keys) 
and any operation other than scrolling is performed, MTP 
automatically enters text selection and ends the selection at 
the end of the line. 

Format display: is invalid, 
ESC r (MOVE) 

Text display: moves both text and column selections. 
However, the move is performed differently, depending on 
whether a text or column selection is being moved. 

Text selection: moves the selection of text to the cursor 
position. Text at and to the right of the cursor position shift 
right. 
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Column selection moves the column selection right or left to 
the column position defined by the cursor. Columns can 
move horizontally only. The text in the lines containing the 
column shifts left or right to accommodate the selection. 
The cursor's vertical position does not affect the placement 
of text. 

Format display, is invalid. 
ESC s (COPY) 

Text display: copies both text and column selections. 
However, the copy is performed differently, depending on 
whether a text or column selection is being copied. 

Text selection: copies the text selection beginning at the 
cursor position, which can be anywhere in display memory 
below the selection. Existing text shifts right to 
accommodate the selection. 

Column selection: copies the column selection right or left to 
the column position defined by the cursor position. Columns 
can be copied horizontally only. The text in the lines 
containing the column shifts left or right to accommodate 
the selection. The cursor's vertical position does not affect 
the placement of the text. 

Format display: is invalid. 
ESC 0 (CODE-d) 

Text display: clears the content of display memory. The 
cursor is moved to the home position. Any selection is deleted. 

Format display: clears the content of the unprotected fields 
but does not affect the formatting of display memory. 
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Format Manageinent 
Loading a Form 

The procedure for loading a form is as follows: 

1 Specify text display (with the ESC X escape sequence 
(see the "Field Definition" subsection). 

2 Clear display memory with the ESC 0 escape sequence 
(see the "Editing" subsection). 

3 Place the text and graphics into display memory. 

4 Define the fields (see the "Field Definition" subsection). 

5 Specify format display with the ESC W escape sequence 
(see the "Field Definition" subsection). 

Once MTP is in format display, only the content of those 
fields defined as unprotected can be modified. 

Field Definition 

The field definition escape sequences organize display 
memory into a form. A form can contain up to 100 fields. 

Fields can be located anywhere in display memory and are 
numbered between 0 and 99. Field definitions are 
maintained separately from display memory and, therefore, 
do not occupy character positions within display memory. 
Fields must be contained on the line and cannot overlap. 
Any area of display memory that is not part of a defined 
field is protected. 

A field is defined by 

□ Starting location in display memory (starting line and 
column). 

o Length, in characters. 

□ Primary and secondary attributes, which select the field's 
display (for example, reverse video) and input (for 
example, alphabetic only or alphanumeric) characteristics. 

□ Type of verification, which selects the range of table, 
look-up table, or field verification program label to be used 
in verifying input. 



Escape Sequences 



3-21 



A field is not considered to be fully defined until a length is 
associated with it. The length attribute is cleared whenever 
the field's location (line or column) is changed. This prevents 
conditions where fields temporarily overlap or extend past 
the end of the line. 

Escape Sequences 

The escape sequences for field definition are summarized in 
Table 3-5. A more detailed discussion follows the table. 

Table 3-5 Escape Sequences for Field Definition 



Escape 

Sequence Definition 

ESC W Specifies format display 

ESC X Specifies text display 

ESC t Clears format display 

ESC:/7 F Specifies a field number 

ESC:n G Specifies a field's beginning column 

ESC:/7 H Specifies a field's line 

ESC:n I Specifies a field's length 

ESC:a? J Specifies a field's primary attributes 

ESC.A? Y Specifies a field's type of verification 

ESC:n Z Specifies a field's secondary attributes 
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ESC W 

Formats display memory according to the current field 
definitions. All areas of the video display hot defined as 
unprotected fields are protected. The cursor is positioned to 
the first field in the form. 



ESC X 

Specifies text display and moves the cursor to the home 
down positron. 

ESC t 

Clears format display by deleting all field definitions, 
specifying text mode, and moving the cursor to the home 
down position. 

ISE:/7 F 

Specifies n as the field nufnber for subsequent field 
definition operation (for example, field Ibtation). The 
workstati<>n beeps if the specified^ number exceeds the 
maximum f ield number (99). 

Field selection does not affect the cursor position. However, 
eil^her user-entered keystrokes or th^ ESC:/?; O escape 
sequence can move the cursor to the new fifefitf. 

ES€:/7 G 

Specifies h a^s the beginning colurnn of a selected field; 
ESC:/7H 

Specifies n as the line of a serbcted fieldl 
ESC:/i I 

Specifies n as the length (in characters) of a selected fieldi 
The field must be contained on one line and cannot extend 
past the width of the video dis|i>lay: Fields carlhbV 6\/eH^|5i 
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ESC:/? J 

Specifies n as a primary attribute of a specified field. Each 
field has attributes that define its display {for example, 
reverse video) and input (for example, alphanumeric fields) 
characteristics. 

Data verification is performed either when the character is 
entered or when an attempt to leave the field is made. 
(Input verification can be overridden by the user's manually 
moving the cursor out of the field.) 

The primary attribute specification is 16 bits long. Setting, a 
bit specifies the attribute associated with that bit. Bit 0 
refers to the least significant bit in the attribute word. 

The primary attribute bits and their corresponding attributes 
are as follows: 

Bit Attribute 

0 Half-bright reverse video. 

The field is displayed in half-bright reverse video. 

1 Underline. 

The character positions in the field are 
underlined. 

2 Reverse video. 

The field is displayed in reverse video. 

3 Blinking characters. 

The characters in the field blink. 

4 Confidential data. 

The field's content is not displayed as it is 
entered. This attribute is useful for passwords. 

5 Protected field. 

The content of this field cannot be modified. 
The tab and backspace escape sequences skip 
this field. The "Protected field" message is 
displayed in the status frame if there is an 
attempt to modify the content of this field. If 
bit 5 is set, bits 6 through 1 5 are ignored. 
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Bit Attribute 



No blanks allowed. 

The field must be completely filled in; spaces 
are not allowed in the field. The message 
"Capacity control field" is displayed in the 
status frame if there is an attempt to leave the 
field. 

Field modified. 

This attribute is set by MTP whenever the 
content of the field is modified. The ESC e 
escape sequence transmits the content of all 
fields that have this bit set. This bit is reset if 
the field is erased. 



8 Automatic exit (auto-exit). 

The next field is automatically selected 
whenever the cursor reaches the end of the 
current field. The content of the current field is 
verified according to the field's input attributes 
before the next field is selected. 

9 Required field. 

The user must enter at least one character 
(other than blank) into this field. If the field is 
left blank, the message "Required field" is 
displayed in the status frame. 

10 Left justify. 

Data in this field must be left justified. If they 
are not, the message "Left justify field" is 
displayed in the status frame. 

1 1 Right justify. 

Data in this field must be right justified. If they 
are not, the message "Right justify field" is 
displayed in the status frame. 

1 2 Numeric data only. 

Only numeric data (0 through 9), the hyphen (-) 
and the period (.) are allowed in this field. The 
message "numeric field" is displayed in the 
status frame if the user enters a nonnumeric 
character. 
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Bit Attribute 

13 Alphabetic data. 

Only alphabetic characters (A through Z and a 
through z), a space (), the hyphen (-), and the 
period (.) are allowed in this field. The nnessage 
"alphabetic field" is displayed in the status 
frame if the user enters any other character. 

14 Look-up table. 

The entry must match an item in the list of 
valid entries in the specified lookrup table. The 
look-up table number to use is provided by the 
ESC:n Y escape sequence. (If both bits 14 and 
1 5 are set, one but not both are used in the 
ESC:a7 Y escape sequence.) 

15 Numeric range. 

The entry must lie within the specified range. 
The specified range is provided by the ESC:/7 Y 
escape sequence. (If both bits 14 and 15 are 
set, one but not both are used in the ESC:n Y 
escape sequence.) 



ESC./I Y 

Specifies a field's type of verification, that is, whether the 
verification will be according to a look-up table, a range 
table, and/or the field verification program. 

If bit 1 4 in the primary attribute is set, the value of n 
specifies the look-up table to be used for verifying a user's 
entry. (Look-up tables are loaded with the ESC:n T "string" 
escape sequence; refer to the "Look-up Table" subsection.) 

The number of the look-up table can be used as the label for 
the field verification program. 

If bit 1 5 in the primary attribute is set, the value of n 
specifies the range table to be used for verifying a user's 
entry. See the "Range Tables" subsection below for 
information on loading the range tables. The number of the 
range table can be used as the label of the field verification 
program. 
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ESC:/7 Z 

Specifies a? as a secondary attribute of the specified field. 
Each field has attributes that specify if the field is to contain 
today's date and if the field verification program is to be 
entered. The secondary attributes and their corresponding 
descriptions are 

Bit Attribute 

0 Enter today's date. 

The current date is entered in the field when 
the form is initially loaded. 

1 Verify field upon entry. 

The field verification program is executed at the 
label specified by the ESCia? Y escape 
sequence before moving the cursor to the field. 

2 Verify field upon exit. 

The field verification program is executed at the 
label specified by the ESC:a7 Y escape 
sequence before leaving the field. 



If either bit 1 or 2 is selected in the field's secondary 
attribute, the value of n specifies the 8-bit label of the input 
verification program to be used to verify a user's entry. The 
label can be the same as the number of the look-up or range 
table. 

Look-Up Tables 

Look-up tables contain a list of entries against which a 
user's entry is verified. MTP supports up to four look-up 
tables. A look-up table is loaded with a set of valid entries 
for a field. For example, entries in a field can be restricted to 
the responses Yes, No, and Maybe. A user's entry that 
does not match any of these three possibilities is flagged as 
invalid, and the message "An invalid choice has been 
entered" is displayed in the status frame. The user must 
correct the entry before continuing. 
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Space for a look-up table is taken from display memory; the 
available number of lines of display memory is 
correspondingly decreased. Allocating space for a look-up 
table clears display memory and the content of the field 
verification program, as well as other look-up tables. 
Therefore, define look-up tables before loading a form. 

To select look-up table verification for a field, the look-up 
table bit (bit 14) in the primary attribute word must be set, 
and the look-up table number must be specified in the ESCia? 
Y escape sequence. 

Escape Sequences 

The escape sequences for defining look-up tables are 
summarized in Table 3-6. 

Table 3-6 Escape Sequences for Look-Up Table Definition 

Escape Definition 
Sequence 

ESC:r7 S Allocates space for a look-up table 

ESC:/7 T" string" Specifies the text of a look-up table 

ESC:/7 U Specifies a look-up table 

ESC:n S 

Allocates n bytes from display memory for the look-up table 
specified in the ESC:/? U escape sequence. 

ESC:ji r'string" 

Specifies the text of look-up table n. The content of the 
look-up table is replaced with the new text. The text 
consists of any number of variable length entries separated 
by semicolons. Semicolons cannot be used as entries in the 
table or as delimiters, n must be between 0 and 3. 
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The length of the string (table entries plus semicolons) is 
limited to the number of characters specified in the last 
allocation escape sequence. For example, to have only the 
responses YES, NO and MAYBE valid for a field, the escape 
sequence to load the look-up table would be 

ESC :0 U /* Select table 0 */ 

ESC:13 S /* Allocate. 13 bytes for table*/ 

ESC:0 T " YES ; NO ; MAYBE /* Enter data */ 



ESC:/i U 

Specifies a look-up table for the subsequent ESC:a7 S escape 
sequence. The ESC:/? U escape sequence must precede the 
ESC:n S escape sequence for allocating space for the 
look-up table, n must be between 0 and 3. 

Range Tables 

Range tables contain numeric ranges against which a user's 
entry is verified. A field can be verified against any of eight 
range tables. Multiple fields can be verified against the same 
range table. 

Range verification of a user's entry occurs when the numeric 
range bit (bit 1 5) in the primary attribute word is set (see . 
ESC:n J escape sequence) and a range table is specified in 
the ESC:a? Y escape sequence. A user's entry is verifies 
when the user leaves the field. If the data entered are not 
within the specified range, the message "The value is not 
within the allowed range" is displayed in the status frame, 
and the cursor is not moved to the next field. 

Escape Sequences 

The escape sequences for range table definition are 
summarized in Table 3-7. A more detailed discussion 
follows the table. 



Escape Sequences 



3-29 



Table 3-7 Escape Sequences for Range Table Definition 



Escape 
Sequence 



Definition 



ESC:a7 U 



Specifies n as the range table to be 
loaded, n must be between 0 and 7. 



ESC:n V 



Specifies n as the lower limit of the 
selected range table, n must be a 
positive number 



ESC:a? W 



Specifies n as the upper limit of the 
selected range table, n must be a 
positive number. 



Field Verification 

User's input can be verified using a simple but flexible 
interpretative program that can do more complex verification 
than the numeric, alphabetic, range, or look-up table checks. 
This program verifies fields according to 
unspecified-specified criteria, such as all numbers must be 
even or field 1 must be less than field 2. A complete 
description of the field verification program is provided in 
the "Field Verification Program" section. 

As with look-up tables, the space for the field verification 
program is obtained from display memory and should be 
allocated before placing any data in display memory. When 
space is reserved for the field verification program, display 
memory and any look-up tables are cleared. 

The field verification program contains program labels that 
can be invoked when a user enters or exits a field. The 
starting label address to be executed is specified in the 
index field. The program statements following the label are 
executed until a return statement is processed. 

The program labels can also be called directly with an 
escape sequence. 

Escape Sequences 

The escape sequences for defining the field verification 
program are summarized in Table 3-8. A more detailed 
discussion follows the table. 
1182649 
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Table 3-8 Escape Sequences for Field Verification 



Escape 
Sequence 



Definition 



ESC \text\Loads 
the field verification 
program 



ESC.n X 



Allocates space for the field 
verification program 



ESC:a7 « 



Executes the field verification 
program at label n 



ESC \text\ 

Loads the specified text into the field verification program 
buffer. The length of the text must not exceed the allocated 
size of the field verification progriam. 

The content of display memory and any look-up tables are 
cleared. 



ES0:iiX 

Allocates n bytes from display memory for the field 
verification program. If this sequence is invoked more than 
once, the size of display merriory is increased or decreased 
to aocomnriodate the new len§th. 

ESCrii - 

Executes the portion of the field verififcafiOn pHXjgrarh 
identified by label /?. 
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Programmable Strings 

MTP provides 66 programmable strings of 80 characters 
each for storing application-specific data. These 
programmable strings provide a powerful mechanism for 
customizing MTP for particular applications. Two types of 
programmable strings are available: those with a content 
associated with special programmable keys and those with 
a content used in special MTP functions. 

Programmable strings associated with programmable keys 
are invoked whenever the associated key is entered to MTP 
(either the key is pressed or an escape sequence activating 
the key is received from the file or over the communications 
channel). When a programmable string is invoked, its 
content is read by MTP as if the data stored in the 
programmable string were entered from the keyboard. 

Programmable strings can contain any combination of text 
and MTP escape sequences. Thus, programmable keys can 
be customized to enter escape sequences and/or transmit 
and display text specific to a user's application. 
Programmable strings associated with programmable keys 
can invoke portions of the field verification program with 
escape sequences, thereby allowing field verification 
functions to be invoked by the user from the keyboard (see 
the "Field Verification Program" section). 

Programmable strings associated with special MTP functions 
contain text used in these functions. Programmable strings 
are available for: 

□ File specifications 

□ Answerback, end-of-line, end-of -transmission, and 
backspace sequences 

o Messages from the host computer 

□ Status and error messages 

□ Outgoing X.25 user's data 

□ Called number for X.25 



Five strings are provided for use as general-purpose work 
areas. These strings can be used for temporary data storage. 
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Programmable strings are manipulated with escape 
sequences. These escape sequences take numeric 
arguments, which reference the string to be manipulated. 
The numeric identificmiohs fot the pfogrartimabte Sitnnfg3 sTre 
listed in Table 3-9. 

Table 3*9 Programmable keys and Functidnti 
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0 


HFl P 


1 
1 


f1 


o 


f9 

I^C 


O 
v) 


TO 


A 
•t 




R 
%J 


1 %^ 


A 
\J 


1 v# 


7 


(If) 


o 


f7 




lO 


in 


XQ 


1 1 


fin 


1 £l 


CUltZT.UCI p 

ontr 1 -ncUf 


1 O 


CUIET.fl 
onir 1 "I 1 


1* 


sHrr-f2 


IS 


$Hrr-f3 


16 


SMIFT-f4 


17 


SHIFT-F5 


18 


SHIFT-f6 


19 


SHI^T-dO 


20 


Sf#T-f7 


21 


SWIFT-f8 


22 


SHlFT-f9 


23 


SHIFT-flO 


24 


CODE-HELP 


25 


C0DE-f1 


26 


C0DE-f2 


27 


COOE-f3 


28 


C0DE-f4 


29 


C00E-f5 
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Table 3-9 Programmable Keys and Functions (Cont'd) 

Function Programmable 

Identification Key or Function 

30 C0DE-f6 

31 CODE-GO 

32 C0DE-f7 

33 C0DE-f8 

34 C0DE-f9 

35 CODE-flO 

36 TAB 

37 CODE-TAB 

38 RETURN 

39 CODE-RETURN 

40 1/2 

41 SHIFT- 1/2 

42 CODE- 1/2 

43 CODE-SHIFT- 1/2 

44 FINISH 

45 CODE-FINISH 

46 SHIFT-FINISH 

47 Answerback 

48 Input file specification 

49 Output file specification 

50 Printer file specification 

51 Recording file specifications 

52 End-of-line sequence 

53 End-of-transmission sequence 

54 Host Computer operator 

55 Local (cluster) operator message 

56 Work area 

57 Work area 

58 Work area 

59 Work area 

60 Work area 

61 Host computer ID message 

62 Error message 

63 Backspace sequence 

64 Telephone number 

65 User data for X.25 
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Escape Sequences 

The escape sequences for manipulating: progrannmable 
function strings are summarized in Table 3-10. A more 
detailed discussion follows the table. 

Table 3-10 Escape Sequences for Programmable String Manipulation 

Escape Description 
Sequence 

ESC:/? A Clears a programmable string 

ESC:/7 > Appends a field to a programmable 



ESe:irA 

Clears the text of programmable string n. 

Appends the content to a field selected wi#» the ESC:n F 
escape sequence to the contemt of programmable string n. 

Processes programmafate stinimgj n, 
ESC: n @"text" 



string 



ESC:/? ? 



Activates a programmable string 



ESC:/? ©"text- 



Appends text to a programmable 
string 



Appends the specified: t^^et to programmafete string/;?. Each 
programmable string csm }^am u|p m S© characters of text. 
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Communications 

Escape sequences for communications are separated into 
the following groups: 

□ Establishment and monitoring of communications 

□ X.25 Network Gateway communications 

□ Information transfer 

The communications establishment escape sequences 
should be issued to MTP before a connection is made to the 
host computer. This is especially important when the 
connection to the host computer is made with a modem. 
Changing any of the communications parameters can break 
the connection with the host. 

Establishment and Monitoring of Communications 

Communications must be established before MTP can be 
used to transmit data. An attempt to transmit data before a 
connection is established causes the message "No 
connection to host" to be displayed in the status frame. 

Escape Sequences 

The escape sequence for establishing and monitoring 
communications are summarized in Table 3-11. A more 
detailed discussion follows the table. 

Table 3-1 1 Escape Sequences for Communications Establishment and 
Monitoring 

Escape Description 
Sequence 

ESCrn h Specifies hexadecimal display 

ESC:n k Specifies automatic line feed mode 

ESC:/7 m Specifies monitor mode 



1102649 



3-36 



Escape Sequences 



ESCin h 

Specifies hexadecimal display mode, which translates each 
character received from the host computer as two 
hexadecimal characters, then enters the hexadecimal 
characters into display memory. As in monitor mode (see 
below), escape sequences from the host computer are 
displayed but not interpreted. For example, if hexadecimal 
display mode is selected, the ESC 0 escape sequence 
(which ordinarily deletes display memory) is displayed on the 
screen as 1 Bh 30h but does not affect display memory. 

A non-zero value for n enables hexadecimal display mode; a 
zero value for n disables it. 



ESC:/? k 

Specifies automatic line feed mode. A carriage return (CR) or 
line feed (LF) from the host computer is translated as CR/LF 
in display memory. If the host sends a CR/LF sequence, an 
extra line feed is not added. 

A non-zero value for n enables the automatic line feed 
mode; a zero value for n disables it. 

ESC:^ m 

Specifies monitor mode. Transmissions from the host 
computer are placed directly into display memory without 
processing. As in hexadeeimaJ display mode (see ESC:/? h), 
escape sequences from the host computer are displayed but 
not interpreted. For example, if monitor mode is selected, 
the ESC 0 escape sequence (which ordinarily clears display 
memory) is displayed on tfie screen as 0 but does not affect 
display memory. 

A non-zero value for n enablies monitor mode; a zero value 
for n disables it. 

X.25 Network Gateway Gotiiffiiuiicafiiinr 

MTP allows the workstation to operate oh public data 
networks (PDN) using the X.25 Network Gateway. The X.25 
Network Gateway allows the user to establish virtual circuits 
to either originate calls to the X.25 PDN or respond to 
incoming calls from the X.25 PDN. 
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MTP provides packet assembly/disassembly (PAD) facilities 
when used with the X.25 Network Gateway. 
Communications with the host computer over the X.25 PDN 
can be initiated by either MTP or the host computer. 

For incoming calls, the range of port addresses to respond 
to can be specified. 

For outgoing calls, MTP allows the user to specify the 
number to call and, optionally, any data during call 
establishment. There is no provision for per-call facilities to 
be requested when a call is established. 

Escape Sequences 

The escape sequences for X.25 Network Gateway 
communications are summarized in Table 3-12. A more 
detailed discussion follows the table. 

Table 3-12 Escape Sequences for X.25 Network Gateway 
Communications 

Escape Description 
Sequence 

ESC % Accepts an incoming call 

ESC & Places an outgoing call 

ESC:/7 b Specifies a break option 

ESC:/7 n Specifies the X.25 port address 



lower limit 



ESC:a) o 



Specifies the X.25 port address 
upper limit 



ESC:4q 



Enables the X.25 
communications option.* 



* Applies to Software release 5.0 only. 
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Table 3-12 Escape Sequence^ for X.25 Networti Gateway 
Commumpatiqns (Cont'd!) 

Escape Description 



ESC:64 A Clears the called number 

ESC:64 ©"text" Appends text to the called number 

ESC: 64 > Appends the content of the current 

field to the called number 

ESC:65 A Clears the content of the user's data 

string 

ESC:65 ©"text" Appends text to the user's data 
string 

ESC:65 > Appends the content of the current 

field to the user's data string 



ESC % 

Causes MTP to wait for an incoming call from the host 
computer. The message "WAIT-FOR-CALL" is displayed in 
the status frame. Cancel the operation by pressing 
ACTION^CANCEL. 

Once a call is received, a connection is established with the 
host computer. The user data field of the incoming call 
packet is moved to display memory. Data are received from 
or transmitted to the host as detailed in the "Information 
Transfer" subsection. 

The call is disconnected by accepting another incoming call 
or by placing an outgoing call. 



ESC & 

Establishes a connection to the host computer, using the 
content of the current number (programmable string 64) and 
user data string (programmable string 65) to place the call. 
While the connection is being established, the message 
"CALLING" is displayed in the status frame. Cancel the 
operation by pressing ACTION-CANCEL. 



Escape Sequences 



3-39 



Once a call is established, data can be received from or 
transmitted to the host computer as detailed in the 
"Information Transfer" subsection. 

The call is disconnected by accepting an incoming call or by 
placing another outgoing call. 

ESCn b 

Specifies /? as a break option, where n is the bit 
corresponding to the option: 



Bit 


Option 


0 


Send interrupt 


1 


Close line 


2 


Send indication of break message 


3 


Reserved 


4 


Flush buffer 


5-7 


Reserved 



ESC:/i n 

Specifies a? as a lower limit for port addresses for incoming 
calls. 

ESC:ff 0 

Specifies n as an upper limit for port addresses for incoming 
calls. 

ESC:64 A 

Clears the called number. 
ESC:64 @''text" 

Appends the specified text to the called number. 
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ESC:64 > 

Appends the content of the current field to the called number. 
ESC:65 A 

Clears the content of the user's data string. 
ESC:65 ©"text" 

Appends the specified text to the user's data string. 
ESC:65 > 

Appends the content of the current field to -he user's data 
string. 

Transmission Type Specification 

Escape sequences can specify the transmission type for 
communicating with the host computer. The transmission 
type depends on the host and the particular application. 

Escape Sequences 

The escape sequences for transmission type specification 
are summarized in Table 3-13. A more detailed discussion 
follows the table. 

Table 3-13 Escape Sequences for Transmission of Type Specification 

Escape Description 
Sequence 

ESC j Specifies conversational transmission 



without local echo 



ESC k 



Specifies block transmission 



ESC w 



Specifies conversational transmission 
with local echo 
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ESC j 

Specifies conversational transmission without local echo. 
This type of communication is referred to as full-duplex 
mode. Data entered through the keyboard are sent to the 
host computer but are not entered into display memory. 

ESC k 

Specifies block transmission. In block transmission, data are 
entered into display memory only. Text must be transmitted 
from display memory to the host by using other escape 
sequences. 



ESC w 

Specifies conversational transmission with local echo. This 
type of communication is referred to as half-duplex mode. 
Data entered through the keyboard are entered into display 
memory as well as sent to the host. 



Information Transfer 

Various escape sequences are provided to transfer data to 
the host computer. 

MTP maintains various strings that are sent to the host 
when requested. For example, the end-of-text string is sefn't 
to the host computer after a file or the content of display 
memory has been transmitted. 

The strings used in information transfer (and their 
identification number; see Table 3-9) are described with 
their escape seqjences. These strings can contain up to 80 
bytes of information. 

Escape Sequences 

The escape sequences for information transfer are 
summarized in Table 3-14. A more detailed discussion 
follows the table. 
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Table 3-14 Escaim Sequnnqe^ fjoir Ififqrinplioii Jm^-^ 

Escape Ol^sipriiitipn 
Sequence 

ESC L Te)(t d/sp/ay transmits a line 

Format display transmits a field 

ESC P Transmits a |br^ak Inclication 

ESC Y Transmits a file to the host 

ESC d Text cfep/a/ transmits display 

memory 

Format display transnriits only the 
cpnt^pt of all gnprotected fields 

ESC e Tm display transmit? a iseteetion 

Format display transmits only the 
content of modified fields 

ESC x"text" Transmits text to the host 

ESC ©"xmx" Monitors input from the host for the 

sppcifieci message 

ESC:47 A Clears answerback string 

ESe:47 ©"text" Appends text to answerback string 

ESC: 52 A Clears end-of-line string 

ESC:52 @ "text" Appends text to end-of-line string 

ESC: 53 A Clepfs pnd-pf-tr^nsm!3sipn string 

ESC: 53 ©"text" Appends te)(t to end pf-tran^mi^sipn 
string 

ESC:63 A Clears backspace string 

ESC: 63 ©"text" Appends text to backspace string 
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ESC L 

Text display, transmits the content of the current line from 
the left margin to the cursor position, to the host computer. 

Format display, transmits the content of the current field 
from the beginning of the field to the cursor position, to the 
host computer. 

ESC P 

Transmits the break indication defined by the ESC:nb 
escape sequence to the host computer. 

ESC Y 

Transmits the content of the current input file to the host 
computer. Line feeds in the file are translated to end-of-line 
strings. The text is terminated by the end-of-text string. 

Instructions for specifying the input file are described in the 
"File and Printer Management" subsection. 

ESCd 

Text display: transmits the content of display memory to the 
host computer; blank lines at the end of display memory are 
not transmitted. The end-of-text string is transmitted at the 
end of the data. 

Format display: transmits the content of all unprotected 
fields to the host computer. The format of the bytes sent to 
the host computer is: 

n: content EOL EOT 

Where: 

n is the field number, in BCD. 

content is the content of the field, in ASCII. 

EOL is the end-of-line string. 

EOT is the end-of-transmission string. 

ESCe 

Text display: transmits the content of the selected text, 
defined by the ESC p (MARK key) and ESC q (BOUND key) 
escape sequences, to the host computer. The end-of-text 
string terminates the transmission. 
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Format display, transmits the content of the unprotected 
fields that have been modified by the user to the host 
computer. The format is the same as specified for the ESC 
d escape sequence. 

ESC x'W 

Transmits a text string of up to 80 characters to the host 
computer. 

ESC ©"text" 

Enables MTP monitoring of input for a designated message 
from the host computer. MTP processes data received from 
the host until encountering a match with the supplied string. 
When a match occurs, MTP passes control to the next 
escape sequence. If the string is null, MTP proceeds 
immediately to the next escape sequence. 

The message "WAIT-FOR-HOST" is displayed in the status 
frame. If the designated message is not received from the 
host computer within 30 seconds, the message "Timed out 
waiting for host ' is displayed in the status frame. Cancel the 
operation by pressing ACTION-CANCEL. 

ESC:47A |SC:47 @>xt ' 

Signifies an answerback, which is sent to the ESC: 47 
@"text" host computer in response to an ENQ character 
(05h) received from the host computer. The ESC:47 A 
escape sequence clears the answerback string, the ESC:47 
©"text" escape sequence appends the speciffed text to the 
answerback string. 

ESC:52 A ESC:52 @"lext" 

Signifies an end-of-line string, which is sent to the host 
computer following transmitted lines. This string permits 
sending sequences such as CF, IF, NUL, NUL, independent 
of MTP internal line terminators. The ESC: 52 A escape 
sequence clears the end-of-line string, and the ESC: 52 
©"text" escape sequence appends the specified text to the 
end-of-line string. 
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ESC:53 A ESC:53 ©"text" 

Signifies an end-of-transmission string, which is sent to the 
host computer after data have been transferred to the host 
computer by the ESC Y, ESC d, or ESC e escape sequence. 
The ESC:53 A escape sequence clears the 
end-of-transmission string, and the ESC:53 ©"text" escape 
sequence appends the specified text to the 
end-of-transmission string. 

ESC:63 A ESC:63 ©"text" 

Signifies a backspace string, which is sent to the host 
computer when a backspace character (08h) is encountered 
in text sent to the host computer. The backspace string is 
substituted for the backspace character. The ESC:63 A 
escape sequence clears the backspace string, and the 
ESC:63 ©"text" escape sequence appends the specified 
text to the backspace string. 

File and Printer Management 

MTP can simultaneously access up to four files: input, 
output, printer, and recording. The file specifications for 
these files are stored in programmable strings and 
manipulated with programmable string commands (see the 
"Programmable Strings" subsection). Each of the four files is 
used for a specific function: 

□ Input files read data into display memory, enter 
commands (including the field verification program) to 
MTP, or transmit data to the host computer. 

D Output files write data from display memory to a disk. 

□ Printer files print data from display memory. The printer 
file specification can be any valid printer or spooler byte 
stream name; this can be a local printer byte stream, a 
spooler byte stream, or any disk file. 

□ Recording files record, on disk, data received over the 
communications channel. 

These character strings are initialized in the same manner as 
programmable function keys, by using the ESC:n A, ESC:n 
©"text", and ESC:n escape sequences. For example, the 
sequence ESC:48 A ESC:48 @"My File" initializes the input 
file specification to "My File." A file operation such as ESC y 
would then use "My File" as its input file. 
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Escape Sequences 

The escapfe sequences for file and printer m^nagenr^ent are 
summarized in Table 3-15. A more detailed discussion 
follows the table. 

Table 3-15 Escape Sequences for File and Printer Management 



Sequence 

ESC Y 
ESCm 



ESC o 
ESCu 



ESC V 



ESC Y 

ESC 6 
ESC 7 



Key 

CODE-c 

None 

None 



None 
None 



None 



None 

None 
None 



Description 

Enters the escape character 
from the keyboard 

Transmits an input file to the 
host 

Text display writes the text 
selection to an output file 

Format display writes the 
content of the modified fields 
to an output file 

Deletes an output file 

Text display reads an input file 
into display memory 

Format display reads an input 
file into the iinprotected fields 
in display rrietmory 

Text display writes the 
content of display memory to 
an output file 

Format display writes the 
qontent of the unprotected 
fields to an output file 

Prope^ises ^n input file as 
escape sequences 

Turns on file recording 

Turns off file recording 
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Table 3*1 5 Escape Sequences for File and Printer Management (Cont'd) 



Escape 
Sequence 

ESC 8 

ESC 9 

ESC + 



ESC- 



ESC - 



Key 

CODE-8 
CODE-9 

None 



None 



None 



Description 

Turns on printer logging 
Turns off printer logging 

Text display prints the content 
of display memory 

Format display prints the 
content of the unprotected 
fields . 

Text display prints a selection 

Format display is invalid 

Text display prints the content 
of the window 

Format display prints the 
content of the unprotected 
fields shown in the window 



ESC Y 

Transmits the content of the current input file to the host 
computer. Line feeds in the file are translated to the 
end-of-line string. The text is terminated by the end-of-text 
string. 

See the "Information Transfer" subsection for details on 
specifying the end-of-line and end-of-text strings. 
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ESC 111 

Text display: writes the text selection to th^ dirtpftit tile. 3ee 
the "Editint)" subs^dtioh \bt iHfdfrhatfdh dri sfeiectidHS. 

Format display: writes the content of the hrtddifi^ct 
unprotected fields; to tft§ dtrtput fife. thdrvrtWafl ffelds aire 
separated by fine feeds. 

CODE-e 

Enters the escape character from the keyboard. 
iMetes th^ GU^reiit oaf put fife. 

isc u 

T^xt dispfefy: read^ tlie input file literally into display memory. 
(Jhlike the 6SC y eiscap^ ie(C|Uende (^6^ bilbw); however, 
ESC CI transfers escap^^ seqbehees directlV^ ihto- display 
memory and does not interpret tfiieml 

fiot^matf display: reads the content of the input file ihtp the 
unpmfett^d field#^ 6f display mehfioryl Individual fi6ld^ in the 
fenn ^HbuJd^ be se^j^etBtied' by line feed^ 

fe)(^ display: v#it^^ the cbhty H¥ 6f ^ trt# displr|^ rri^Hior^ to an 
output ipile. 

to an butptit fite. 
ESC y 

Reads the input fife and prbcesses^^th# cN*&<r^^ as if they 
were received front tK# ridst cdrffpfiftife^: 

ESC 6 

Enables file recording. If the recording filer already exists, it is 
opened and new data are appended to the previous content 
of the file. If no recording file exists, one is created. All 
characters received from the host computer are placed in 
the recording file in addition to being placed in display menriory. 
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ESC 7 

Causes MTP to terminate recording of characters received 
from the host computer. Any recording file that is currently 
open is closed. The ESC 7 escape sequence does not affect 
data being read into display memory. 

ESC 8 (CODE-8) 

Directs non-control characters received from the host 
computer to the printer in addition to placing them in display 
memory. 

If file recording is also selected, characters are also copied 
to the recording file. The other print options (print video 
display, print selection, and print display memory) cannot be 
selected while printer logging is enabled. 

ESC 9 (CODE-9) 

Terminates logging to the printer. 
ESC + 

Text display: Prints the content of display memory. The 
printing of spaces at the end of display memory is 
suppressed. 

Format display: Prints the content of all the unprotected 
fields. Line feeds are placed between the fields. 

ESC- 

Text display: Prints the selection (see the "Editing" 
subsection for further information on selections). 

Format display: is invalid. 
ESC - 

Text display: Prints the current content of the display window. 

Format display: Prints the current content of all the 
unprotected fields shown in the display window. Line feeds 
are placed between the fields. 
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Display Menidry Mdiiigeiileiit 

Display memory management escape seiqueHices ^llbW the 
user to clear display memory and to select status and video 
display options. 

Escape Sequences 

The escape sequences for display memory management are 
summarized in Table 3-16. A moi-e detailed discussion 
follows the table. 

Table 3-16 Escape Sequences for Display Memory Management 
Escape 

Sequence Key De^cri^tidn 

ESC 0 CODE-d Text display Clears display 



merhofy 



ESC:/i d 



None 



Fdrftiait dtsiplpy/ Clears all 
unprotected fields 
Specifies a status display 



ESC:a? j 



None 



Specifies visibte line feeds 



ESG:/7l 



None 



Specifics thfe video suppress 
option 



ESC:a7 z 



CODE-z 




Fdrmai: dl^fil^ i^ ih\/^ltrd 



Text d/sptay: Clears tH^ c^rft^rlt of ^diWf^ 
Format dfspfdy: Clears the^cont^dfaffl tH^ii^ 
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ESC:/? d 

Specifies the content of the second line of the status franne 
of the video display. The values for n are 

0 - blank line 

1 » communications information 

2 - file information 

3 - video control information 

(hexadecimal display) 



4 - host computer messages and local operator messages 

A change in the host computer or local operator message 
supersedes the selection until a new mode is selected. 

Status display information is controlled locally when the user 
presses ACTION-NEXT, which selects the next type of 
display message (see values of n). 

ESC:/7 j 

Specifies visible line feed characters. Each line feed 
character in display memory can be either invisible or 
displayed to the user as a curving down arrow («/). 
Specifying a nonzero value for n makes line feed characters 
in the text visible. 



ESC:/7 1 

Prevents characters received from the host computer from 
being copied into display memory. However, escape 
sequences from the host still affect display memory. In 
addition, characters from the host are sent to the recording 
and print files if either or both options are selected. 
Characters entered by the user are still entered into display 
memory. 

Specifying a nonzero value for n suppresses displaying 
characters received from the host computer. 
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ESC:ii z (CODE-^z) 

Text display: selects between 80 and 132 columns as the 
width of display memory depending dn the workstation and 
the option chosen. When the width changes, display 
memory is cleared and the cursor moves to the home position . 

Format display: is invalid. 



Sorting 

In text display, MTP provides escape sequences for sorting 
entries in display memory. A column of text must be 
selected (see the "Editing" subsection). The sort escape 
sequences order the lines of text within the limits of the 
selection. For example, if display memory contains 



00 11 This is line 1. 

0002 This is line 2. 

00 1 8 This is lihie 3. 

0001 This is line 4. 



and the coluhin selection is the first four characters of each 
of the three lines, the ascending sort escape sequence 
would order displiay memory as fdlldws: 

0001 This is line 4. 

0002 This is lihe 2. 
0011 This is line 1. 
0©1€ This i^^ lih^ 31 



Sorting is performed according to the ASCIi sequence of the 
characters comprisihg the cotuhih; 



Escape Sequences 



3-53 



Escape Sequences 

The escape sequence for sorting are summarized in Table 3-17. 



Table 3-17 Escape Sequences for Sorting 



Escape 
Sequence 

ESC > 



ESC< 



Key Description 

CODE-] Text display performs an 

ascending sort of the column 
selection. 

Format display is invalid. 

CODE-[ Text display performs a 

descending sort of the 
column selection. 



Format display Is invalid 



Miscellaneous Operations 

MTP provides escape sequences for locking and unlocking 
the keyboard, resetting MTP, processing errors,'and 
synchronizing transmission. 



Escape Sequences 

The escape sequences for these miscellaneous operations 
are summarized in Table 3-18. 
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Table 3>18 Escape Sequences for IVIiscellaneous Operations 



Escape 
Sequence 

ESCb 

ESCc 

ESCg 

ESC 

ESC* 

ESC F-text" 

ESC A 
ESC:n K 

ESC:n L 
ESC:r; g 



Key 

CANCEL 
None 

SHIFT-CANCEL 

CODE-a 

CODE-CANCEL 
None 

None 

CODE-FINISH 

None 

None 



Description 

Unlocks tho keyboard 
Locks the keyboard 
Performs a 

communications reset 

Accepts the next 
character literally 

Performs an MTP reset 

Processes a 
progr^mmclble string 
when an error occurs 

Enters today's date 

Terminates MTP with 
the spf Qffied error code 

Sets pr resets keyboard 
Dilays MTP 



ESC b mnm) 

Unlocks the keyboard and clears the ^rror message from the 
status frame. 

ESC c 

Locks the keyboard, thereby preventing a user from entering 
data until either CANCEL is pressed or ESC is propps^ed 
from the host or frpm a pommand fite. 
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ESC g (SHIFT-CANCEL) 

Performs a communications reset. Printer logging, file 
recording, hexadecimal displaying, and/or monitoring are 
disabled. Text display is specified. 

ESC ' (CODE-a) 

Accepts the next character literally. For example, ESC ESC 
allows a user to pass ESC (IBh) to MTP without 
interruption. 

ESC * (CODE-CANCEL) 

Resets MTP to its initial state. Display memory, format 
information (such as tabs and margins), and the 
programmable function keys (advanced operations) are 
cleared. Text display is selected. The communication 
parameters are reset to their initial state. Any host 
connection is dropped. If the HELP key is pressed, it is 
initialized to read in the initialization file [Sys]<Sys>MTP-INI. 

ESC ?"text" 

Processes the provided string if an error condition currently 
exists. For example, 

ESC & ESC ? "NO answer from host" 

would place the message "NO answer from host" in the 
status frame if the call were not successful. 

ESC A 

Enters today's date in the form mm/dd/yy at the cursor 
location. 

ESC:ii K (CODE-FINISH) 

Terminates MTP and transmits BTOS Operating System 
error code to the Error Exit system common procedure (see 
the BTOS Reference Manual). 
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mm 

Turns the keyboard LEDs on or off. n is a bit mask of the 
LEDs to be turned on or off. If a bit is 0, the LED is turned 
off; if the bit is 1 , the LED is turned on. 

The LEDs and their bits are: 



LED 


Bit 


F1 


5 


F2 


4 


F3 


3 


F8 


2 


F9 


1 


F10 


0 


f Se : 0 9 





Delays MTP for the time reqiiested in, m tenths of seconds) 
Pces^mg ACTION-CANCEL at the keyboard cancete the delay. 

TWs eseape sequence is useful for ailowing time for host 
computer processing when sending, iitrformation to the host 
cop|)uter. 
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Field Verification Program 

The field verification program provides the ability to 
construct an interpretive program to adapt MTP to specific 
user applications. Although, as its name implies, its primary 
use is for input verification, the field verification program can 
also be used for complex functions such as the 
interpretation of host computer messages and for arithmetic 
calculations. 

The field verification program is loaded into an area 
allocated from display memory either from the host over a 
communications channel or from a file. 

The field verification program is executed by a calling 
function, either automatically when a field is entered or 
exited or when an escape sequence from a programmable 
key or a file is activated. The calling function specifies the 
location in the field verification program where execution is 
to begin. Field verification statements allow returning to the 
calling function when field verification processing is 
complete. 

The field verification program consists of a series of 
instructions in a low-level language interpreted by MTP. This 
language consists of the following elements: 

□ Data items 

D Arithmetic statements 

□ Labels 

□ Transfer statements 

□ Return statements 

□ Put statements 

Field verification program statements are separated by 
linefeeds or semicolons; they also wrap around from one 
line to another. All keywords must be in uppercase (for 
example, "GO 1" is valid; "go 1" is invalid). The keywords 
are shown in Table 4-1 . 
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Table 4-1 Field Verification Progrpin Keywords 



Keyword Definition 

A Accumulator 

C Current field 

CANCEL Check for user intervention 

ERROR Check for error condition 

F Field 

GO Unconditional transfer 

IF Conditional transfer 

L Label 

P Put 

RF Return if false 

RT Return if true 



Data Items 

Data items consist of accumulators, fields, and constants. 
The field verification program allows the user to test and 
manipulate these items. 



Accumulators 

Accumulators are memory areas internal to MTP that can be 
used to store numeric values in the field verification 
program. The thirty-two accumulators are referenced as AO, 
A1, ... A30, A31. Accumulators contain positive integer 
values from 0 to 4,294,967i295 ^nd can be manipulated by 
arithmetic statements or tested usirig conditional transfer 
statements. 
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Fields 

MTP supports forms containing up to 100 fields (see the 
"Format Management" subsection in Section 3 for 
information about fields). Fields are referenced as FO to F99; 
in addition, the content of the current field can be 
referenced as C. 

Fields can be treated as character strings. A field can be 
tested for equality or inequality (for example, IF F4 = "Y" 
GO 4). 

Fields can also be treatedKas accumulators and manipulated 
by arithmetic statements or tested using conditional transfer 
statements. Fields can have values from 0 to 
4,294,967,295 as long as the field length is large enough 
to accommodate the value. For example, a field of length 3 
has a maximum value of 999. 

Altering the content of a field changes the content of 
display memory. For example, FO = 1 causes the content 
field 0 to be redisplayed with the value 1 . 

Constants 

Constants can be either positive integers or character 
strings. Integers can be used in all arithmetic tests. 
Character strings can be used in logical testing (equality or 
inequality) with fields. 

Arithmetic Statements 

Arithmetic statements perform arithmetic or Boolean 
operations on fields, accumulators, and numeric constants. 
The operations are shown in Table 4-2. 
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Table 4-2 Field Verification Program Arithmetic Operations 

Operator Operation 

+ Addition 

Subtraction 
/ Division 

Multiplication 
& Logical AND 

! Logical OR 

I! Logical XOR 

The result is stored in an accumulator or in a field in display 
memory. All operations are performed on 32-bit quantities. 
If the result is placed in a field, the result is truncated to the 
field size. For example, only 456 of the number 23456 
would be placed in a field of length 3. 

Arithmetic statementshave the format A/? - operand where: 

n is the accumulator number 0 

through 31 . 

operand is either a single operand- (for 

example A1 - 1) or one 
operator and two operands 
(for example, AT « At + 1)> 



Examples of arithmetic statements are: 
A l « F3 + 12 

A7 « A7 - 1 

A7 « 3 
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More complex compositions, such as A1 = A1 + A2 -f 
A3, are not allowed. These operations must be divided into 
steps (for example A1 « A1 + A2; A1 - A1 + A3). 

All operations work on 32-bit quantities with the following 

limitations: 

1 Multiplication is between a 32-bit multiplicand and a 
16-bit multiplier. 

2 Division is between a 32-bit dividend and a 16-bit divisor. 



Labels 

Labels separate groups of statements and provide a means 
for transferring control to the field verification program. 
Labels have the format In , where n can range from 0 to 255 . 

Labels of equivalent numerical value are considered equal. 
For example, L01 equals LI; L004 equals L4. 

Control is passed to labels by transfer statements from 
within the field verification program; by escape sequences 
(for example, ESC:1 ^ ); or by entering and exiting fields 
(see the "Format Management" subsection in Section 3). 
Statennents following a label are executed until a return 
statennent is encountered. 

Transfer Statements 

There are two types of field verification program transfer 
statements: unconditional and conditional. 

Unconditional transfer statements transfer control to 
statements following the identified label. Unconditional 
transfer statements have the format GO n , where n is the 
label of the statement to which control is to be transferred. 
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Conditional transfer statements transfer control to the 
statements following the specified label only if the condition 
is true. If the test fails, control is transferred to the 
statement following the conditional transfer statenrrent. The 
conditions tests are: 

- equal to (equality) 

^ not equal to (inequality) 

< less than 

> greater than 

:s less than or equal to 



Tests with string constants are limited to equality (-) and 
inequality ( #). 

Three types of tests are allowed: 

□ arithmetic comparisons, for example, 

IF A1 - 0 GO 99 
IF F3 < F2 GO 100 
IF F28 > 0 GO 76 

□ string comparisons, for example, 

IF F10 = "Y" GO 1 

□ special variable testing, for example, 

IF ERROR GO 200 

IF CANCEL GO 10 

In arithmetic comparisons, accumulators, fields, and numeric 
constants can be compared against each other. If the 
content of a field is to be compared, it is first converted 
from a character string (the representation of fields in 
display memory) to a number. Spaces, whether leading, 
trailing, or embedded, are ignored. 
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String Comparisons are allowed only with fields, not 
accumulators or constants. The comparison is 
case-insensitive (for example, 'a' = 'A'). Strings are 
delimited by single (') or double (") quotation marks. String 
comparisons are performed only when the second operand 
is a string constant. An arithmetic, not a string, comparison 
is performed in the statement IF F1 - F2 GO 12. 

Two special variable tests are provided: ERROR and CANCEL. 
ERROR is TRUE if the condition currently exists; CANCEL is 
TRUE if the user pressed ACTION-CANCEL. User 
intervention is considered an error, so ERROR is TRUE 
whenever CANCEL is TRUE. Therefore, the CANCEL variable 
should be tested first if both conditions are to be tested. 

The variables are reset to FALSE by the reset escape 
sequences (ESC g, or ESC*) or by testing the variables (IF 
ERROR GO 12). 

Return Stateinents 

Return statements transfer control from the field verification 
program to the calling function. Return statements return a 
Boolean value, if control was passed to the field verification 
program by entering or exiting a field, the returned value is 
used to control whether the cursor is to be advanced to the 
next field in the form or is to remain in the current field. If 
FALSE is returned, the workstation beeps. The programmer 
should indicate the cause of the error. For example, in the 
following program only even numbers are accepted as input. 
It is assumed that control is transferred to L1 upon exiting 
fieldj. 

L1 

AQ-FI&I 
IF AO -0GQ2 

P "£80:51 A ESC:51 @'Even numbers only'" 

RF 

L2 

RT 

Return statements have the format: 
RT (returns TRUE) 

RF {returns FALSE) 
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Put Statements 

Put statements display text and execute escape sequences. 
Put statements are useful for entering MTP escape 
sequences from the field verification program. Strings 
displayed with put statements are treated as keyboard input 
by MTP. 

The format of the put statement is P "text string" 

where "text string" is the text to be displayed, the escape 
sequence to be invoked, or any combination thereof. 

If the text string in a put statement specifies the content of 
accumulators or fields, the data are converted to text 
strings before being displayed. In the following examples, 
the escape sequence is indicated by "ESC". See Section 3 
for details on the actual strings that must be used. 

The following example uses the put statement to display 
text at the cursor position in display memory: 

"Aquick brown fox jumped over the lazy 
dog . " 

The following example transmits the same text on the 
communications channel: 

P "ESC: x*Aquick brown fox jumped over the 
lazy dog. * " 

The following example displays an error message in the 
error message area of the status frame: 

P"ESC:51AESC:51@*NotYorN; tryagaln.*" 
The following example transmits a file to the host computer: 
P-ESC:48AESC:48@*Sysdemomy-fi le*ESCY" 
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The following example displays the content of accumulator 
9 at the cursor position: 

p A9 

The following example displays the content of field 10 at 
the cursor position: 

P F t 0 

Comment Statements 

Comment statements can be placed in the field verification 
program. Comments have the format /* x...x */. 

Comment statements are stripped from the program when it 
is loaded and therefore do not require space in the field 
verification program. 

Loading the Field Verification Program 

The field verification program uses space obtained from 
display memory. When space is reserved for the field 
verification program, the display memory and look-up tables 
are cleared. Therefore, allocate space for the field 
verification program before placing any text in display memory. 

Once space has been allocated, the field verification 
program is loaded using the escape sequence ESC \text\, 
where \text\ is the actual field verification program. This 
escape sequence clears the program buffer; therefore, the 
program must be completely loaded in one operation. 

Executing the Field Verification Program 

The field verification program can be evoked through an 
escape sequence or when entering or exiting a field while in 
format display. 

The escape sequence ESC:a7 « transfers control to label n of 
the field verification program. This escape sequence can be 
received from the host computer over the communications 
channel, read from a file, or activated by pressing a 
programmable key. 

In format display, fields can possess attributes that specify 
that control is to be transferred to a field verification 
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program label when the field is entered, exited, or both. 
(See the subsection on "Format Management" for more 
details.) 

Transferring control upon field entry is useful when special 
instructions are to be given about the field to be defined (for 
example, "Enter Yes or No") or when the field can contain a 
default value (for example, C - F1 +89). 

Transferring control upon field exit is useful for field 
verification when the verification is too complex to be 
handled by MTP built-in functions, such as range checking 
(for example, IF C - F4 GO 8). 



Defining the Current Field 

The keyword C is used to define the current field. The rules 
for the current field are as follows: 

□ If the field verification program was invoked by entering a 
new field, C is the new field. 

□ If the field verification program was invoked by exiting a 
field, C is the field that was exited. 

o C can be redefined by the escape sequence ESC:/? F, 
which selects a field but does not reposition the cursor, 
or ESC:/7 O, which selects the field and positions the cursor. 

Error Reporting 

Syntax checking is performed as the field verification 
program is executed. Errors are reported in the error 
message area of the status frame (status line 4, the reverse 
video line). Errors are prefaced with "EditProg - ". In 
addition, the 20 characters following the error are displayed. 
For example, the sequence 

A1 « A2@3; A2 « 0 would result in the message 

EditProg- inval jdnumericoperator3;A2-0 

Error messages are documented in Appendix A of the 
Multimode Terminal Program (MTP) Operations Guide. 



Appendix A 



A-1 



Status and Error Messages 

MTP status and error messages are listed in the BTOS 
Multimode Terminal Program (MTP) Operations Guide. 
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Escape Sequences Cross-Reference 

ESCAPE sequences consist of the escape character 
followed by one or more characters. The escape character 
itself is IBh. In this nnanual, this character is represented by 
ESC. Whenever a key or key combination is associated with 
an escape sequence the key or key combination is also shown. 

The escape sequences are cross-referenced by (1) escape 
sequence, (2) description, and (3) key. 



Crosis-Reference by Escape Sequence 

The escape sequences in this subsection are ordered first 
by uppercase letters, then by lowercase letters, by 
numbers, by special characters according to their ASCII 
representation, and, finally, by variables. 

Eiscape Key Description 

Sequence 



ESC A I Moves the cursor up 

ESC B 1 Moves the cursor 

down 



ESC C — * Moves the cursor right 

ESC D Moves the cursor left 

ESC E CODE-MARK Text display, cancels 

the selection 
Format dispfay: is 
ihvaiid 



ESC F CODE-J, Text display, moves the 

cursor to the home 
down position 
Format display: moves 
the cursor to the first 
unprotected field 
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Cross-Reference by Escape Sequence 

Escape Key Description 

Sequence 

ESC G CODE-4— Text display, moves the 

cursor to the home left 
position 

Format display, moves 
the cursor to the first 
position of the current 
field 

ESC H CODE-T Text display, moves the 

cursor to the home 
position 

Format display, moves 
the cursor to the first 
position of the first 
unprotected field 

ESC I TAB Text display: moves the 

cursor to the next tab 
stop 

Format display, moves 
the cursor to the 
beginning of the next 
unprotected field 

ESC J Text display, deletes to 

the end of display 
memory 

Format display, is 
invalid 

ESC K Text display, deletes to 

the end of the line 
Format display, deletes 
to the unprotected field 

ESC L Text display: transmits 

a line 

Format display: 
transmits a field 



Escape Sequences Cross-Reference 



B-3 



Escape 
Sequence 

ESC M 



ESC N 



ESC O 



ESC P 

ESCQ 
ESC R 

ESCS 

ESCT 

ESC U 

ESC V 

ESC W 

ESC X 



Key 

SHIFT-DELETE 



OVERTYPE 
DELETE 



OVERTYPE 
SCROLL UP 
SCROLL DOWN 
NEXT PAGE 
PREV PAGE 



Description 



Text display: deletes 
the current line 
Format display, deletes 
the content of the 
current unprotected 
field 



Enters overtype mode 
LED on. 



Text display: deletes 
the current character 
Format display: deletes 
the current character in 
an unprotected field 

Transmits a break 
indication 

Reserved 

Enters insert mode 
(LED off) 

Scrolls display memory 
up one line 

Scrolls display memory 
down one line 

Scrolls display memory 
to the next page 

Scrolls display memory 
to the previous page 

Specifies format 
display 

Specifies text display 
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Escape 
Sequence 


Key 


Description 


ESC Y 




Transmits a file to the 
host computer for 
information transfer 

Transmits an input file 
to the host computer 
for file and printer 
management 


ESC Z 




Reserved 


ESC a 




Requests the cursor 
position be transmitted 
over the 
communications 
channel 


ESC b 


CANCEL 


Unlocks the keyboard 


ESC c 




Locks the keyboard 


ESCd 




Text display: transmits 
display memory 
Format display: 
transmits all 
unprotected fields 


ESC e 




Text display: transmits 
a selection 
Format display: 
transmits only the 
content of modified 
fields 


ESC f 


CODE-BOUND 


Text display: ends the 
column selection 
Format display: is 
invalid 



ESCg 



SHIFT-CANCEL 



Performs a 

communications reset 
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Escape Key Description 
Sequence 

ESC h Reserved 

ESC i CODE-TAB Text display: moves 



the cursor to the 
previous tab stop 

Format display: moves 
the cursor to the first 
character position of 
the current unprotected 
field or the first 
position of the 
previous field 

ESC j Specifies 

conversational 
transmission without 
local echo 

ESC k Specifies block 

transmission 

ESC I CODE-DELETE Text display: deletes a 

selection 

Format display: is 
invalid 

ESC m Text display: writes the 

text selection to an 
output file 

Format display: writes 
the content of the 
modified fields to an 
output file 
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Escape Key 
Sequence 

ESC n CODE--. 



Description 



Text display: moves 
the cursor to the home 
right position 
Format display, moves 
the cursor to last 
nonblank character 
column of the current 
field 



ESC o Deletes an output file 

ESC p MARK Text display: begins a 

text or column 
selection 
Format display: is 
invalid 



ESCq BOUND 

ESC r MOVE 
ESC s COPY 



Text display: ends a 
text selection 
Format display: is 
invalid 

Text display: moves a 
selection 

Format display, is invalid 

Text display: copies a 
selection 
Format display: is 
invalid 



Clears format display 

Text display: reads an 
input file into display 
memory 

Format display: reads 
an input file into the 
unprotected fields in 
display memory 
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Escape 
Sequence 


Key 


Description 


ESC V 




Text display: writes the 
content of display 
memory to an output file 
Format display, writes 
the content of the 
unprotected fields to 
an output file 


ESC w 




Specifies 
conversational 
transmission with local 
echo 


ESC X "text" 




Transmits text to the 
host computer 


ESC y 




Processes an input file 
as escape sequences 


ESC 2 




Reserved 


ESCO 


CODE-d 


Text display: clears the 
content of display 
memory for editing 
Clears display, memory 
for display memory 
management 
Format display: clears 
the content of all 
unprotected fields for 
editing 

Clears all unprotected 
fields for display 
memory management 


ESC 1 


CODE-e 


Text display: Sets a 
tab stop 

Format display: is 
invalid 
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Escape Key 
Sequence 

ESC 2 CODE-f 

ESC 3 CODE-g 
ESC 4 

ESC 5 CODE-i 

ESC 6 None 

ESC 7 None 

ESC 8 CODE-8 

ESC 9 CODE-9 

ESC ! 
ESC " 
ESC #C 
ESC$ 



Description 



Text display: removes 
a tab stop 

Format display: is 
invalid 

Text display: removes 
all tab stops 

Format display: is 
invalid 

Reserved 

Text display: sets the 
right margin 

Format display: is 
invalid 

Turns on file 
recording 

Turns off file 
recording 

Turns on printer 
logging 

Turns off printer 
logging 

Reserved 

Reserved 

Reserved 

Reserved 
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Escape 
Sequence 



Key 



Description 



ESC % 



ESC & 



None 



None 



Accepts an incoming 
call for X. 2 5 Network 
Gateway 
communications 

Places an outgoing 
call for X.25 Network 
Gateway 
communications 



ESC ' 

ESC( 
ESC ) 
ESC * 
ESC + 



CODE-a 



ESC - 

ESC . 
ESC/ 
ESC < 



CODE-CANCEL 



CODE-( 



Accepts the next 
character literally 

Reserved 

Reserved 

Performs an MTP reset 

Text display: prints the 
contents of display 
memory 

Format display: prints 
the contents of the 
unprotected field 

Text display: prints a 
selection 
Format display: is 
invalid 

Reserved 

Reserved 

Text display: performs a 
descending sort 



ESC/text/ 



Loads the field 
verification program 
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Escape 
Sequence 


Key 


Description 


ESC = 




Text display; prints the 
contents of the 
window 

Format display: prints 
the contents of the 
unprotected fields 
shown in the window 


ESC > 


CODE-] 


Text display: performs 
an ascending sort 
Format display: is 
invalid 


ESC ?"text" 




Processes a 
programmable string 
when an error occurs 


ESC ©"text" 




Monitors for a host 
computer message 


ESC [ 




Reserved 


ESC A 




Enters today's date 


ESC - 




Reserved 


ESC:n A 




Clears a programmable 
string 


ESC:a7 B 




Moves the cursor to 
line n 


ESC:nC 




Moves the cursor to 
column n of the current 

III ixs 


ESC:n D 




Reserved 


ESC:n E 




Reserved 
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Escape Key 


Description 


Sequence 




ESC:n F 


Specifies a field 




number 


ESC:/? G 


Specifies a field's 




starting colunin 


ESC:a7 H 


Specifies a field's line 


ESC:/7 1 


Specifies a field's 




length 


ESC:/7 J 


Specifies a field's 




primary attributes 




1 erminaies ivi i r witn 




the specified error 




code 


ESC:n L 


Sets or resets the 




Keyuoara Ltus 


bou./7 M 


Reserved 


ESC:a7 N 


Reserved 


ESC:a7 0 


Text display, is invalid 




Format display, moves 




the cursor to 




unprotected field n 


ESC:a7 P 


Reserved 


ESG:4q 


Enables the X.25 




communications option.* 


ESC:a7 R 


Reserved 


ESC:a7 S 


Allocates space for a 




look-up table 


ESC:a7 T"string" 


Specifies the text of a 




look-up table 



^Applies to Software release 5.0 only. 

1182649-001 
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Escape Key Description 

Sequence 



ESC:n U Specifies a look-up 

table 

ESC:/7 U Specifies a range table 

ESC:a7 V Specifies the lower 

limit of the range table 

ESC:a7 W Specifies the upper 

linnit of the range table 

ESC:a7 X Allocates space for the 

field verification 
program 

ESC:n Y Specifies a field's type 

of verification 

ESC:a7 Z Specifies a field's 

secondary attributes 

ESC: A? a Reserved 

ESC:a? b Specifies the break 

option 

ESC:/7 c Reserved 

ESC:a7 d Specifies a status 

display 

ESC:/7 e Reserved 

ESC'.n f Reserved 

ESC:a7 g Perform a 

communications reset 

ESC:/7 h Specifies hexadecimal 

display mode 
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Escape Key Description 

Sequence 

£SC:n i Reserved 

ESC:n j Specifies visible line 

feeds 

ESC:/7 k Specifies automatic line 

feed mode 

ESC:/7 I Specifies the video 

suppress option 

ESC.n m Specifies monitor 

mode 

ESC:n n Specifies the X.25 port 

address lower limit 

ESC:n o Specifies the X.25 port 

address upper limit 

ESC:a7 p Reserved 

ESC:n q Reserved 

ESC:n r Reserved 

ESC:/7 s Reserved 

ESC:/7 1 Reserved 

ESC:/7 u Reserved 

ESC:/7 V Reserved 

ESC.f? w Reserved 

ESC:/7 X Reserved 

ESC:/? y Reserved 
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Escape Key 
Sequence 

ESC:a7 z CODE-z 

ESC:a7 
ESC:n« 

ESC:a7 > 

ESC:n ? 
ESC:n ©"text" 
ESC:64 A 
ESC:64@"text" 

ESC:64 > 

ESC:65 A 
ESC:65@"text" 

ESC?65> 



Description 



Text display, specifies 
the video display width 
Format display: is 
invalid 

Reserved 

Executes the field 
verification program at 
label n 

Appends a field to a 
programmable string 
for programmable keys 
and functions 

Processes a 
programmable string 

Appends text to a 
programmable string 

Clears the called 
number 

Appends the specified 
text to the called 
number 

Appends the content 
of the current field to 
the called number 

Clears the content of 
the user's data string 

Appends the specified 
text to the user's data 
string 

Appends the content of 
the current field to the 
user's data stnng 
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Cross-Reference by Description 

Key 



Description 


Escape 




Sequence 


Accepts an incoming 


ESC% 


call for X.25 Network 




Gateway 




communications 




Accepts the next 


ESC ' 


character literally 




Activates a 


ESC:a7 ? 


programrnable string 




All . *" .1 

Allocates space for the 


ESC:n X 


field verification 




program 




Allocates space for a 


ESC:r? S 


look-up table 




Appends a field to a 


ESG:/7 > 


programmable string 




for oroarammable kevs 




and functions 




Appends the text to a 


ESC:a7 @ 


Droarammable strina 




Append^ the content 


ESC: 64 


of the current field to 




the called number 




Appends the specified 


ESC:64 ( 


text to the called 




number 




Appends the specified 


ESC:65 1 


text to the user's data 




string 





"text" 



COD£-a 



"text" 



"text" 
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Escape Sequences Cross-Reference 



Description 



Begins a text or 
column selection (text 
display only) 

Cancels the selection 
(text display only) 

Clears a programmable 
string 

Clears format display 

Clears all unprotected 
fields for display 
memory management 
(format display only) 

Clears display memory 
for display 
management (text 
display only) 

Clears the content of 
all unprotected fields 
for editing (format 
display only) 

Clears the content of 
display memory (text 
display only) 

Clears the called number 

Clears the content of 
the user's data string 



Copies a selection (text 
display only) 



Escape 
Sequence 

ESC p 



ESC E 

ESC:/7 A 

ESC t 
ESCO 

ESCO 

ESCO 

ESCO 

ESC:64 A 
ESC:65 ©"text" 

ESC s 



Key 

MARK 

CODE-MARK 



CODE-d 



CODE-d 



CODE-d 



CODE-d 



COPY 



Delays MTP 



ESC:n g 
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Description Escape Key 

Sequence 

Deletes an output file ESC o 

Deletes a selection ESC I CODE-DELETE 

(text display only) 

Deletes the content of ESC M SHIFT-DELETE 
the current unprotected 
field (format display 
only) 

Deletes the current line 
(text display only) 

Deletes the current 
character (text display 
only) 



ESC M SHIFT-DELETE 
ESC 0 DELETE 



Deletes the current 
character in an 
unprotected field 
(format display only) 

Deletes to the end of 
display memory (text 
display only) 

Deletes to the end of 
the line (text display 
only) 

Deletes to the end of 
the unprotected field 
(format display only) 

Enables the X.25 
communications option.* 

Ends a column ESC f CODE-BOUND 

selection (text display 

only) 

Ends the text selection ESC q BOUND 
(text display only) 

* Applies to Software release 5.0 only, 

1182649-001 



ESC 0 DELETE 

ESC J 

ESC K 
ESC K 
ESC4q 
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Escape Sequences Cross-Reference 



Description 

Enters overtype mode ESC N 



Escape 
Sequence 



Enters insert nnode 



Enters today's date 

Enters the escape 
character 

Executes the field 
verification program at 
label n 

Is invalid (format 
display only) 



Is invalid (text display 
only) 

Loads the field 
verification program 



ESC R 

ESC A 
none 

ESC:/7 - 

ESC E 

ESC J 
ESCf 
ESC I 
ESC p 
ESCq 
ESC r 
ESC s 
ESC 1 
ESC 2 
ESC 3 
ESC 5 
ESC - 
ESC > 
ESC:/7 z 

ESC:n 0 
ESC \text\ 



Key 

OVERTYPE 
(LED on) 

OVERTYPE 
(LED off) 



CODE-c 



Locks the keyboard 



ESC c 
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Description 



Monitors for a host 
computer message 

Moves a selection (text 
display only) 

Moves the cursor down 

Moves the cursor left 

Moves the cursor right 

Moves the cursor to 
column n of the current 
line 

Moves the cursor to 
line n 

Moves the cursor to 
the first character 
position of the current 
unprotected field or the 
first position of the 
previous field (format 
display only) 

Moves the cursor to 
the first position of the 
current field (format 
display only) 

Moves the cursor to 
the first position of the 
first unprotected field 
(format display only) 



Escape 
Sequence 

ESC ©"text " 

ESC r 

ESC B 
ESC D 
ESC C 
ESC:/7 C 

ESC:n B 
ESC i 



Key 



ESC G 



ESC H 



MOVE 
1 



CODE-TAB 



CODE- 



CODE- T 
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Escape Sequences Cross-Reference 



Description 



Moves the cursor to 
the first unprotected 
field (format display 
only) 

Moves the cursor to 
the home down 
position {text display 
only) 

Moves the cursor to 
the home left position 
{text display only) 

Moves the cursor to 
the home right position 
(text display only) 



Escape 
Sequence 

ESCF 



ESC F 



ESC G 



ESC n 



Key 

CODE- i 

CODE- 1 

CODE- ^ 
CODE- 



Moves the cursor to ESC n 

the last nonblank 

column of the current 

field (format display 

only) 

Moves the cursor to ESC I 
the next tab stop (text 
display only) 

Moves the cursor to ESC i 
the previous tab stop 
(text display only) 

Moves the cursor to ESC:r7 0 
unprotected field n 
(format display only) 



CODE- ^ 



TAB 



CODE-TAB 



Moves the cursor up 



ESC A 
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Description 



Performs a 

communications reset 

Performs a descending 
sort (text display only) 

Performs an ascending 
sort (text display only) 



Places an outgoing call 
for X.25 Network 
Gateway 
communications 



Escape 
Sequence 

ESCg 



ESC < 



ESC > 



Performs an MTP reset ESC 



ESC& 



Key 

SHIFT- 
CANCEL 

CODE-[ 
CODE-] 



CODE- 
CANCEL 



Prints a selection (text ESC - 
display only) 

Prints the contents of ESC + 
display memory (text 
display only) 

Prints the contents of ESC -f 
the unprotected fields 
(format display only) 

Prints the contents of ESC « 
the unprotected fields 
shown in the window 
(format display only) 



Prints the content of 
the window (text 
display only) 

Processes a 
programmable string 
when an error occurs 



ESC - 
ESC p-text" 
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Escape Sequences Cross-Reference 



Description 



Processes an input file 
as escape sequences 

Reads an input file into 
display memory (text 
display only) 

Reads an input file into 
the unprotected fields 
in display memory 
(format display only) 

Removes a tab stop 
(text display only) 

Removes all tab stops 
(text display only) 

Requests the cursor 

position be transmitted 

over the 

communications 

channel 

Reserved 



Escape Key 
Sequence 

ESC y 
ESC u 

ESC u 

ESC 2 CODE-f 

ESC 3 CODE-g 
ESC a 



ESCQ 

ESCZ 

ESCh 

ESCz 

ESC 4 

ESC ! 

ESC " 

ESC$ 

ESC( 

ESC) 

ESC . 

ESC/ 

ESC #C 

ESC[ 

ESC- 
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Description 
Reserved 



Escape 
Sequence 

ESC:r? 
ESC:a7 D 
ESC:a7 E 
ESC:a7 M 
ESC:/7 N 
ESC:a> P 
ESC:a7 Q 
ESC:a7 R 
ESC:/7 a 
ESC:/7 c 
ESC:/? e 
ESC:a7 f 
ESC:a7 i 
ESC:/7 1 
ESC:/7 u 
ESC:/7 w 
ESC:/7 X 
ESC:a? y 



Resets the keyboard ESC:/? L 
LEDs 

Scrolls display memory ESC T 
down one line 



Scrolls display memory ESC U 
to the next page 

Scrolls display memory ESC V 
to the previous page 

Scrolls display memory ESC S 
up one line 

Sets a tab stop (text ESC 1 
display only) 

Sets the keyboard LEDs ESC: a? L 



SCROLL 
DOWN 

NEXT PAGE 

PREV PAGE 

SCROLL UP 

CODE-e 
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Escape Sequences Cross-Reference 



Description 



Escape 
Sequence 



Key 



Sets the right margin 



ESC 5 



CODE-i 



(text display only) 

Specifies a field number ESC:/? F 

Specifies a field's type ESC:a7 Y 
of verification 

Specifies a field's length ESC:n I 



Specifies a field's line ESC:n H 

Specifies a field's ESC:/? J 

primary attributes 

Specifies a field's ESC:/? Z 

secondary attributes 

Specifies a field's ESC:/? G 
starting column 

Specifies a look-up table ESC:/? U 

Specifies a range table ESC:/? U 

Specifies a status ESC:/? d 

display 

Specifies automatic line ESC \n k 
feed mode 

Specifies block ESC k 

transmission 

Specifies ESC w 

conversational 

transmission with local 

echo 
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Description 



Specifies 
conversational 
transmission without 
local echo 

Specifies format display 

Specifies hexadecimal 
display mode 

Specifies monitor mode 

Specifies text display 

Specifies the break 
option 

Specifies the lower 
limit of the range table 

Specifies the text of a 
look-up table 

Specifies the upper 
limit of the range table 

Specifies the video 
display width 

Specifies the video 
suppress option 

Specifies the X.25 port 
address lower limit 

Specifies the X.25 port 
address upper limit 

Specifies visible line 
feeds 



Escape Key 
Sequence 

ESC j 

ESC W 
ESC:a7 h 

ESC:/7 m 
ESC X 
ESC:/7 b 

ESC:/7 V 

ESC:/7 T"string" 

ESC:a7 W 

ESC:a7 z CODE-z 
ESC:a7 1 
ESC: n 
ESC:/7 o 
ESC:/? j 
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Escape Sequences Cross-Reference 



Description Escape Key 

Sequence 

Terminates MTP with ESC:/? K 
the specified error code 

Transmits a break ESC P 

indication 

Transmits a field ESC L 

(format display only) 

Transmits a file to the ESC Y 
host computer for 
information transfer 

Transmits a line (text ESC L 
display only) 

Transmits a selection ESC e 
(text display only) 

Transmits all ESC d 

unprotected fields 
(format display only) 

Transmits an input file ESC Y 
to the host computer 
for file and printer 
management 

Transmits display ESC d 

memory (text display 

only) 

Transmits only the ESC e 

content of modified 
fields (format display 
only) 



Transmits text to the 
host computer 



ESC x"text'' 
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Description Escape 

Sequence 

Turns off file recording ESC 7 

Turns off printer logging ESC 9 

Turns on file recording ESC 6 

Turns on printer logging ESC 8 

Unlocks the keyboard ESC b 

Writes the content of ESC v 
display memory to an 
output file (text display 
only) 

Writes the content of ESC m 
the modified fields to 
an output file (format 
display only) 

Writes the text ESC m 

selection to an output 
file (text display only) 

Writes the content of ESC v 
the unprotected fields 
to an output file 
(format display only) 



Key 

CODE-9 

CODE-8 
CANCEL 
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Cross-Reference by Key 

Only those escape sequences associated with particular 
keys are listed. 



Key 

T 
I 



BOUND 

CANCEL 
CODE-1 



CODE-^ 



CODE-I 



Escape 
Sequence 

ESC A 

ESC B 

ESC C 
ESC D 
ESCq 



ESCb 
ESCF 



ESC G 



ESC H 



Description 



Moves the cursor up 

Moves the cursor 
down 

Moves the cursor right 

Moves the cursor left 

Text display: ends a 
text selection 
Format display: is 
invalid 

Unlocks the keyboard 

Text display: moves the 
cursor to the home 
down field 

Format display: moves 
the cursor to the first 
unprotected field 

Text display: moves the 
cursor to the home left 
position 

Format display: moves 
the cursor to the first 
position of the current 
field 

Text display: moves the 
cursor to the home 
position 

Format display: moves 
the cursor to the first 
position of the first 
unprotected field 
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Key Escape 
Sequence 

CODE-— ESC n 

CODE-BOUND ESC f 

CODE-CANCEL ESC * 

CODE-DELETE ESC 1 

CODE-MARK ESC E 
CODE-TAB ESC: 

CODE-c none 

CODE-d ESC 0 



Description 



Text display: moves the 
cursor to the home 
right position 
Format display: moves 
the cursor to the last 
nonblank column 
position of the current 
field 

Text display: ends the 
column selections 
Format display: is 
invalid 

Performs an MTP reset 

Text display: deletes a 
selection 
Format display: is 
invalid 

Text display: Cancels a 
selection 

Text display :vr\ovBS cursor 
to previous tab stop 
Format display: moves 
cursor to first character in 
current field 

Enters the escape 
character 

Text display: clears the 
content of display 
memory for editing 
Clears display memory 
for display memory 
management 
Format display: clears 
the content of all 
unprotected fields for 
editing 



1182649 



B-30 



Escape Sequences Cross-Reference 



Key Escape 
Sequence 

CODE-e ESC 1 

CODE-f ESC 2 

CODE-g ESC 3 

CODE-i ESC 5 

CODE-z 

CODE-8 
CODE-9 
CODE-[ 

CODE-1 ESC > 

COPY ESC s 



Description 



Text display: sets a tab 
Format display: is 
invalid 

Text display: removes a 
tab stop 

Format display: Is 
invalid 



Text display: removes 
all tab stops 
Format display: is 
invalid 

Text display: sets the 
fight margin 
Format display: is 
invalid 



Text display: performs 
an ascending sort 
Format display: is 
invalid 

Text display: copies a 

selection 

Format display: is 



ESC:a7 z Text display: Selects 

video display width 
Format display: is 
invalid 

ESC 8 Turns on printer 

logging 

ESC 9 Turns off printer 

logging 

ESC < Text display: performs a 

descending sort 
Format display: is 
invalid 
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Key 



Escape 
Sequence 



Description 



DELETE 



MARK 



ESC 0 



ESC p 



Text display: deletes 
the current character 
Format display: deletes 
the current character in 
an unprotected field 

Text display: begins a 
text or column 
selection 
Format display: is 
invalid 



MOVE 



ESC r 



Text display: moves a 
selection 
Format display: is 
invalid 



NEXT PAGE 



ESC U 



Scrolls display memory 
to the next page 



OVERTYPE 



OVERTYPE 



PREV PAGE 



SCROLL UP 



ESC N 



ESC R 



ESC V 



SCROLL DOWN ESC T 



ESC S 



Enters overtype mode 
(LED on) 

Enters insert mode 
(LED off) 

Scrolls display memory 
to the previous page 

Scrolls display rriemory 
down one line 

Scrolls display memory 
up one line 



1182649 



B-32 
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Key • Escape 

Sequence 

SHIFT-CANCEL ESC g 
SHIFT-DELETE ESC M 



Description 



Performs a 

communications reset 

Text display: deletes 
the current line 
Format display: deletes 
the content of the 
current unprotected 
field 



Appendix C 
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Examples 

The field verification program allows the user to adapt MTP 
to many environments. This appendix gives examples of the 
field verification program. 

Within this appendix, line numbers have been inserted in 
text examples for reference only and should not be inserted 
in the text. Escape sequence characters are printed as in the 
figures. 

MTP Program Example for Terminal Emulation 

Figure C-1 shows an MTP program that allows a 
workstation to emulate a terminal to a host computer 
through the X.25 Network Gateway. 

The sign-on sequence on the host computer is name and 
password. The sign-on sequence is activated when GO is 
pressed. An automatic sign-off procedure is invoked when 
FINISH is pressed. 

Line 01 enables the automatic linefeed mode. This mode is 
used when the host computer sends only a carriage return 
(CR) or a line feed (LF) as a line terminator, but not both. 

Line 02 sets the X.25 number to 39017245. Functions 
should be cleared before attaching new strings, because the 
ESC:/7 @ function appends to the new string. 

Line 03 initializes the user data string to null. The user data 
string is provided in the INITIATE CALL packet in the X.25 
Network Gateway. (See the BTOS X.25 Gateway Operations 
and Programming Guide for further information.) 

Line 04 initializes the GO key. When this key is pressed, MTP 

1 Selects X.25 communications mode 

2 Initiates the call 

3 Waits three seconds 

4 Sends the character string "george" 

5 Waits one second 

6 Sends the character string "zzz" 
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Figure C-1 MTP Program Example for Terminal Emulation 



o 

ISI 



02 •:64A#:6n§'39017245' 

04 •:7A»:7e''#:4q«fii#:30gqeorge»:10g 

05 •:31Ap:31§'logoutA#:50g»:4q* 

06 •O^w 



222" 



/* enable auto- 1 i ne f eed 
/* specify X.2S call out number 
/* specify user data string 
/* login to computer / 
/* log out ana hang up 
/* clear the screen ... set conv 



1^, 



O) 

3 



Examples 
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The delays are added to ensure that the host computer is 
ready for communicating with MTP. When preparing 
automatic log-in with MTP, strings must not be sent too 
quickly to a host computer. 

Line 05 initializes the FINISH key. When pressed, the FINISH key 



1 Sends the character string "logout" 

2 Waits five seconds 

3 Terminates the X.25 connection 



Line 06 clears display memory and selects half-duplex mode. 

Field Verification Program Example for a Simple 
Calculation 

Figure C-2 shows how to use the field verification program 
in data entry applications. This escape sequence implements 
a simple calculator program. 

Line 01 allocates 600 bytes for the field verification 
program. This operation should be done first, because It not 
only clears any existing field verification program, but also 
clears display memory. 

Line 02 selects and allocates eight bytes for look-up table 
O. The valid responses {+,-,/,and *) for the table are defined. 
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Figure C-2 Field Verification Program Example for a Simple Calculation 



01 
02 
03 
04 
05 
06 
07 
08 
09 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19 
20 
21 
22 
23 
24 
25 
26 
27 



•;600X 

•:0U#:8S#:0T'+ ;-;/;*• 
• :1k 

•:7A»:78'»:1«»H' 

•:0F*:28G*:10H#:5I«:4100J 

•:lF«:23G»:12H*:lI«:17156J»:0y 

•:2P«:2dG«:12H*:5I«:4100J*:4Z«: lY 



•:3F«:23G«:15H«:101*:4J 
•\ 

LI 

IF Fl = " + • GO 2 

IF Fl = GO 3 

IF Fl - "/" GO 4 

IF Fl = GO 5 

P "•:62A«:62§'You must specify 

RF 

L2 

F3 « F0+F2;GO 200 

L3 

IF F0<F2 GO 30 
F3 ^ F0-F2;GO 200 
L30 

F3 » F2-F0;P "•R#:30-" 
GO 200 



/* ALLOCATE SPACE FOR FVP 

/* ALLOCATE/DEFINE LOOKUP TABLE 0 

ALLOW +, ~, / 
/* SEE NOTE (1) 
/* COMPUTE IF GO KEY PRESSED 
/* FIELD 0 (NUMERIC, 5 DIGITS) 
/* FIELD 1 (1 CHAR 

USE TABLE 0 FOR VALID ENTRY 
/* FIELD 2 (NUMERIC, 5 DIGITS) 

EXECUTE FVP AT LABEL 1 ON EXIT 
/* FIELD 3 HOLDS THE RESULT 
/* BEGIN LOADING THE FVP 



an operator 

/• PRINT ERROR MESSAGE 



*/ 

V 

*/ 



/* DISPATCH ACCORDING TO OPERATION */ 



/* PLACE 



SIGN IN FIRST FIELD 



Rgure C-2 Field Verification Program Example for a Simple Calculation (Cont'd) 



2 



i 



28 


L4 








29 


F3 


* F0/F2;GO 200 






30 


L5 








31 


F3 


= F0*F2;GO 200 








L7 






/* MOVE VALUE TO ACCUMULATOR 


33 


AO 


= F3 






34 


P ■ 


• 0" 




/* CLEAR ENTRY FIELDS IN DISPLAY 


35 


FO 


« AO 






36 


RT 








37 


L200 






38 


FO 


= FO; F2 = F2; 




/* IS THE SAME AS A LINE FEED 


39 


P " 


• :30" 




/* POSITION TO FIELD 3 


40 


RT 






/* AUTOMATICALLY MOVES CURSOR TO 


41 








THE NEXT FIELD (I.E. FIELD 0) 


42 


\ 






43 


/* 








44 




THE NEXT LINES DEFINE 


THE PROTECTED TEXT AREA ON THE SCREEN. 


45 




IT IS EASIER TO DO SO 


AFTER 


ALL CONTROL SEQUENCES HAVE BEEN 


46 




INVOKED. 






47 


V 








46 


• 0« 


:OB«:OC 






49 




MTF CALCULATOR 






50 










51 




Key in first number. 


operand 


r and second number. 


52 










53 


•:13B«:20C 


•W«0 





V 



V 



Ul 
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Line 04 selects automatic linefeed mode; this converts 
linefeed (LF) to carriage return/linefeed (CR/LF). This option 
is useful when reading command files created by the BIOS 
Editor that contain text to be displayed or when receiving 
text from the host computer that has either a CR or an LF, 
but not both. 

Line 05 initializes the GO key. When pressed, this key 
passes control to label 1 of the field verification program. 
After the field verification program returns control, the 
cursor is positioned to the first field in the form. 

Line 06 defines field O as starting at line 10, character 
position 28, numeric, and brightly highlighted in reverse video. 

Line 07 defines field 1 as starting at line 1 2, character 
position 23, with a length of one character. Entries to this 
field must match the entries listed in table 0. 

Line 09 defines field 2 as starting at line 12, character 
position 28, numeric, and brightly highlighted in reverse 
video. Exiting from this field transfers control to label 1 (LI 
on line 13) of the field verification program. 

Line 1 1 defines field 3, which is used to store the result of 
the operation. 

Line 1 2 begins the definition of the field verification 
program, which continues until the terminator (\> on Line 42. 

Lines 1 4 through 1 7 dispatch control to the appropriate 
label according to the content of field 1 . 

Line 1 8 displays a message when the user presses GO 
without entering an operator in field 1 . Field validation is 
performed only on exiting a field when the user presses 
TAB or RETURN. Field validation can be disabled by the 
user's pressing the cursor control keys to exit from the field. 

Note: Field validation programs must take this into account 

Lines 20 through 36 perform the operations. The 
subtraction operation checks for a negative result; however, 
the field verification program handles only positive integers. 
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Lines 38 through 39 align the numbers in the input fields. 
Numbers processed by the field verification program are 
right justified. 

Lines 48 through 53 set up the video display text prior to 
selecting format mode. In general, this method is the most 
convenient way of dealing with text. 
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Standard Initialization File 

At initialization, MTP processes the file [Sys]<Sys>MTP-INI 
as a command file. A standard command file that initializes 
MTP as a general purpose terminal is shipped with MTP. 
The escape sequences in this standard file can be changed 
to initialize MTP for specific applications. A listing of the 
standard file is shown in Figure D-1. 

Following an MTP reset operation, the initialization com- 
mand file can be read to reinitialize MTP by pressing the 
HELP key. 
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Figure D-1 Standard Initialization File 



1^ 



/♦ RESERVE SPACE FOR THE PVP ♦/ 
•:6000X 

/* RESERVE SPACE FOR LOOKUP TABLES ♦/ 

•:0U«:40S 

•;1U«:40S 

•:2U«:40S 

/♦ ENABLE A.UTO LINEFEED MODE ♦/ 
• :1k 

/* HELP KEY DISPLAYS FILE MTP-HLP ♦/ 

• : 0A# : 0© • tk* : 7 A« : 4 8A« : 48©* [ sy s ] <3y 8 >MTP-hlp*tX#0#ut : 48A ' 

/♦ SET PROGRAMMABLE STRINGS ♦/ 



/* CODE-PI 
•:25A«:25@'«:10= 

/* C0DE-F2 
•:26A#:26©»#:20= 

/♦ F3 

•:3A»:3©'*P' 

/♦ C0DE-F3 
•:27A«:27§*«:30= 



INITIATE CALL*/ 
, ACCEPT CALL*/ 
. SEND BREAK*/ 
, SET BREAK OPTIONS*/ 



31 



Figure D-1 Standard Initialization File (Cont'd) 



/* P4 

•: 4A«:4^rtO«u' 

/♦ CODE - P4 
•:28A«:28e'#:40=* 

/* P5 

•:5A#:5©*«=' 

/* CODE - P5 
•:29A«:29©' •:80=' 

/♦ P6 

• :6A«:6C?*»+' 

/♦ CODE - P6 
•:30A#:30©V#:55=' 

/♦ P7 

•:8A#:O^»07' 

/♦ CODE - F7 ■ 
•:32A«:32®*«:60=» 

/♦ CODE - P8 
#:33A«:33e*«:70=' 



READ INPUT PILE*/ 
SETUP INPUT PILE*/ 
PRINT SCREEN*/ 
SETUP PRINTER PILE*/ 
PRINT DISPLAY MEMORY*/ 
SETUP MODE ♦/ 
STOP RECORDING ♦/ 
SETUP/START RECORD*/ 
SETUP OUTPUT PILE*/ 



Figure D-l Standard Initialization File (Cont'd) 



/♦ P8 

• :9A«:9©*»V 

/♦ F9 

•:10A«:10©'«Y' 

/♦ FIO 

A*:1 1@*«e* 

/* CODE-GO 

•:31 A«:31@'#:7A«X»0 

/♦FINISH 

•:44A«:44§*«:4q' 

/♦CODE-FINISH 
•:43A#:45©'#:OK' 



. WRITE DISPLAY MEMORY TO OUTPUT FILE 
. TRANSMIT PILE TO HOST*/ 
. TRANSMIT SELECTION*/ 



. CANCEL THE FORM*/ 



, HANGUP THE CALL*/ 
. EXIT THE PROGRAM*/ 



/*END OF LINE SEQUENCE*/ 
•:52A«:52©' 



/*ID MESSAGE*/ 

•:6lA#:6ltf*MULTIMODE TERMINAL .PROGRAM 
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/♦LOAD THE PVP*/ 
• \ 

/♦ CLEARS THE FORM AND CLEARS KEY BEHIND GO*/ 
L255; P "•X#0«N" 

/♦ RESTORES THE CORRECT MODE SETTING AFTER FORM HAS BEEN CLEARED*/ 

L210; IP AO <> 0 GO 211 

P GO 220 

L21 1 ; IF AO <> 1 GO 212 

P "•k«08A»:38©*«n#L' GO 220 

L212; IP AO <> 2 GO 213 

P GO 220 

L215; P "•j" 
L220; P "•:7A"; RT 

/♦INITIATE A CALL*/ 
LIO 

IF A1 > 3 GO 11 ^ 

P "•:62A«:62©*Un<ief ined function for local channelsO'; RP 

LI 1 

P "•k«:1k#:'*; P A1 ; P "q" 
P •••:7At:7d'«:OP#:64A«:64>#:65A#:1F*" 
P t«0« : 0?9 : 7H« : 20G# : 5 1 25 J# : UI " 
P "•:2P«:4H«:14G«:36J«:52I" 

P "•:4B«:15CPILL IN THE FORM AND PRESS GO TO INITIATE THE CALL" 
P "•:2B#:22C* ♦ ♦ INITIATE A CALL ♦ ♦ ♦" 
P "•:7B«:0CNUMBER" 
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IP A1 <> 4 GO 12 

P "•:7e'«:65>>: 1Pii:9H«:20G«:5J«:12I" 

P "•:9B«:0C PACKET DATA"; GO 13 

L12; P "•:7d'«:19='#: 1P#:9H#:20G»:261J#:1I" 

P "•:9B#:0CLINE CLASS" 

L15 

P "•:7€>*#<5b«:255='#W#:00«:64?«:JpO«:38At:58d' J» RT 
L19; P "•:59A#:59©'##*«:59>*:59?"; RT 

/♦ACCEPT A CALL*/ 
L20 

IF A1 > 3 GO 21 . 

P "•:62A#:62©»Undef ined function for local channelsO*; RP 

L21 

P "tk^: 1k#:"; P A1 ; P "q" 

P "t:7A#:7€>'«;OF#;n«: 1F«;*«^«:255 = ' " 

P "•ttO" 

IP A1 =4 GO 22 

P "•:1P«:9H#:20G#:261J«:1 I" 

P "tigB^rOCLINE CLASS" 

GO 23 

L22 

P •••:OP#:7H«:20G»:4357J«:2I" 
P "•:1P«:7H«:60G#:4357J«:2I" 
P "•:7B«:OCL0W PORT" 
P "•:7B»:40CHIGH PORT" 
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L23 

P "•:2Fe:4H«: 14G«:36J#:52I" 

P "#:4B«: 1 5CFILL IN THE FORM AND PRESS GO TO ACCEPT A CALL" 
P "•:2B»:22C* ♦ ♦ ACCEPT A CALL ♦ ♦ 
P "•W#0#:38A«:38d* 

RT 

/♦SET BREAK OPTIONS*/ 
L50 

P "•:7A«:7e'#:35=' " 
P "tk^ttO" 

P "•:OT»YES;NO' " 

P "tiOPtzTH^UOG*: l6389J*:OY«:3r' 
P "•:1F«:9H#:40Gt:16389J«:OY#:3I" 
P "•:2F#:1 1 H«:40G#: 16389J«:0Y«:3I*' 
P "•: 3Ft: 1 3H«:40G«: 1 6389J«:0Y« : 31" 
P "•:4Pt:4H»: 14G«:36J»:52r' 

/♦ highlighted / protected label ♦/ 
P "t :4B»: 1 5CFILL IN THE FORM AND PRESS GO TO SET BREAK OPTIONS" 
P "•:2B«:22C» * ♦ SET BREAK OPTIONS * ♦ 
P "•:7B«:0CSend Interrupt Packet" 
P "•:9B«:0CHangup Call on Break" 
P 1 1 B«:OCSend Break Indication" 
P 1 3B«:0CDiscard Output" 
P "•W#0#:38A»:38©'i<' " 

A10 = A4&7; A20 = A4&16; A20 = A20/2; A10 = A10IA20 
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All = 0; Al 2 = 1 

P P AU ; P "0" 

/* Select the field •/ 
A13 = A10&A12 

/* get designation ♦ 

IF A13 = 0 GO 52 
P "YES"; GO 33 
L32; P "NO" 
L33 

All = All +1 ; A12 = A12*2 
IF All < 4 GO 31 
P "•:00#R" 

RT 

L33; A13 = 0; Al 1 = u; A12 = 1 
L36; P "•:" ;P Al 1 ; ? "F" 
IF C='N' GO 37; A13 = A131A12 
L37; Al 1 = Al 1+1 
L38; A12 = A12*2 

IF A12=8 GO 38 /♦ skip this one ♦/ 

IF All < 4 GO 36 

A4=A13+0; P •"•:"; P A4 ; P "b" 

G 255 
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/♦ SET INPUT PILE*/ 
L40 

P "•k*t«0" 

P "•:7A«:7©'#:0F«:46A#;48>«:56A»:56>«:255 

P "•:OP#:7H#:20G#:5J«:50I" 

P "•:2F#:4Ht:20G«::>6J«:'35I" 

P "•:4B«:23CFILL IN THE FORM AND PRESS GO 

P "•:2B#:22C* * ♦ SETUP INPUT PILE ♦ ♦ 

P "•:7B#:0CFILE NAME" 

P "•W»:56?«: .58A#:3B*j'J' " 

RT 

/♦SET OUTPUT FILE*/ 
L70 

P "•k#t«0" 

P "•:7A#:7@'#:0F«:49A»:49>#:37At:37>«:255 

P "•;OP«:7H«:20G«:5J#:30r' 

P "•:2F«:4H«:20G»:'36J«:35I" 

P "•:4B«:23CPILL IN THE FORM AND PRESS GO 

P "•:2B«:22C* ♦ ♦ SETUP OUTPUT FILE * * 

P "•:7B«:0CPILE NAME" 

P "•W«:57?«:38A#:38C>'J* " 

RT 
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/♦SELECT MODE*/ 
L55 

P ♦••k«ttO" 

P •••:OT'h;f ;e;l*" 

P "•:1TM ;2'" 

P "trZT'n-.e;*;©;! 

P "•:7A#:70»«:57«* " 

P "•:0?«:7H«:40G#:16645J#:0Y«:1I" 

P "•:1P#:4IU:20G«:36J«:35I" 

P "•:4B«:25CFILL IN THE FORM AND PRESS GO" 

P •♦•:2B#:22C» • * SELECT MODE » * *" 

P "•:7B«:0CM0DE (Full. Half, Edit, or Line)" 

IP A1 =4 GO 56 

P " • : 2F# : 9H« : 40G« : 56869 J» : 5 !• : 0Y« : 0U# : 50V# : 1 9200W« 

P "•:3P#:11H«:40G«:20741J«: 1 I#: 1 Y#:1 1" 

P : 4P# : 1 3H# : 40G« : 1 6645 J • : II • : 2Y# : 1 1 " 

P "•:9B«:0CBaud Rate (up to 19200)" 

P 1 lB«:OCStop Bits (1 or 2)" 

P 1 3B»:0CParity (none, even, odd, 0, or 1)" 

P "•W«0#:5BA«:3B^' J' " 

P2 = 9600; F3 1 ; P "•:40N«:00H"; RP 
L56; P "•W#0«:3BA«:3B©*^' RT 

L57 
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i. 

A0=0;A10=0; _. 
IP PO='P* GO 150 • 
IP PO='H' GO 151 
IP PO='E* GO 152 

IP PO=*L* GO 15t ^ g 

P "#:62A«:62e* Invalid Choice •□•:00" 
RF 

LI 50; A0=:A0+1 
LI 51 ; A0=A0+1 
LI 52; A0=A0+1 
L153; 

IP A1 =4 GO 255 

IP P4 = 'N* GO 160; IP F4 = 'E' GO I6I; IP P4 = '0* GO 162; IP P4 = M' GO 163; 
IP P4 = *0' GO 164 ^ 
P "•:62A»:62©* Invalid Cho ice : 40" 
L164; A10=A10+1 
L163; AlOrAIO+l 
L162; A10=A10+1 
L161; A10=A10+1 
LI 60; P "•:"; P A4; P "p" 
A2 = P2; P "•:••; P A2; P "r" 
A5 = P3 ! 1 ; P P A3; P "a" 

GO 255 
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/♦SET RECORDING PILE*/ 
L60 

P "tktttO" 

P " • : 7A« : 7© * • : 0P« : 5 1 At : 5 1 > •X#0«6« : 255 = 

P "•:OF«:7H«:20G#:5J*:':50I" 
P "•:2F#:4H#:14G#:36J»:52I" 

P "•:4B«:15CFILL IN THE FORM AND PRESS GO TO START RECORDING" 

P "•:2B#:22C» ♦ ♦ RECORD SESSION ♦ ♦ 

P "•:7B#:0CFILE NAME" 

P "•V#0#:51?#:00«:58A#:38©'J|'" 

RT 
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/♦SET PRINTER PILE*/ 
L80 

P "•k«t#0" 

P "•:7A#:7©*«:OP*:50A«:50>»X#0«:255=* " 

P "•:OP«:7H#:20a«:5J*:30I" 

P "•:2P«:4H#:22G«:56J#:35I" 

P "•:4B«:25CPILL IN THE FORM AND PRESS GO 

P "•:2B«:22C» * * SETUP PRINTER FILE SPEC 

P •••:7E*:0CPRINTER FILE SPEC" 

P '••W#O#:5O?#:O0«:38A«:58©'J' " 

RT 

LO , 

AO = 0 
Al = 0 
A2 = 0 
A5 = 0 
RT 

/♦SELECT COMM OPTION AT POWER UP*/ 
LI 20 

AO = 0; A1 = 0; A2 = 0; A3 = U 

P "•:7A#:7@' •: 1 21 =• " 

P •••ktttO" 

P : IT' X • e * a * b ' " 

P : 0P# : 1 4H# : 40G» : 5J • : 1 I " 

P " • : 1 P# : 4H0 : 20G« ; 36 J • : 3 5 1 " 

P "•:4B«:23CPILL IN THE FORM AND PRESS GO" 
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P "•:2B«:17C* * ♦ SELECT COMMUNICATION OPTION ♦ ♦ 
P "tiTB^tOCSelect: 

X - X25 

E - Extended Communications" 

P " 

A - Local Channel A 

B - Local Channel B" 
P "•;0C#: UBOPTION (X, E, A or B)" 
P "•W«0«:38A«:38©'J' " 

RT 
L121 
A1 = 1 

IP FO = 'X' GO 133 
IF PO = 'E' GO 132 
IF PO --. 'B' GO 131 
IP PO = 'A' GO 130 

P "•:62A«:624?' Invalid Cho ice ' : 00" 

RP 

L133; A1 = A1 + 1 
L132; Al = A1 + 1 
LI 31 ; A1 = A1 + 1 
LI 30; P P Al ; P "q"; GO 55 



/*END OP FVP*/ 

\ 

/♦START EXECUTION WITH POWER UP FORM*/ 
•:120= 




Appendix E 
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Hardware Considerations 

X.25 Communications 

See the BTOS X.25 Gateway Operations and Programming 
Guide for information on hardware considerations for X.25 
communications. 
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Accept an incoming call, 3-38 

Accept the next character literally, 3-55 

Accumulators, 4-2 

Activate d programmable string, 3-34 
Allocate space: 

for field verification program, 3-30 

for look up table, 3-27 
Append: 

content of field, 3-40 

field to a programmable string, 3-34 

text to a programmable string, 3-34 

specified text to called number, 3-39 

specified text to data string, 3-40 
Arithmetic comparisons, 4-6 

Begin a selection, 3-18 

Block transmission. See Transmission types. 

Calling function, 4-1 

Cancel current selection, 3-16 

Clear: 

called number, 3-39 

content of user's data string, 3-40 

content of unprotected fields, 3-19 

display memory, 3-19, 3-50 

format display, 3-22 

programmable string, 3-34 
Column selection, 3-18 
Command, 2-5 

files, 2-5 
Communications, 3-35 

options, 2-3 

X.25 Network Gateway, 3-36 
Comparisons: 

arithmetic, 4-6 

string, 4-7 
Configurability, 2-5 

Conversational transmission. See Transmission types. 

Copy a selection, 3-19 

Cursor control, 3-4, 3-6 to 3-8, 3-12 

Delays MTP, 3*56 
Delete: 

character at cursor position, 3-17 

contents of current unprotected field, 3-16 

current line, 3-16 

current text character, 3-17 

output file, 3-48 

selection, 3-18 

to end of display memory, 3-16 

to end of current unprotected field, 3-16 
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to end of line, 3-16 
Display characteristics, 11 
Display memory, 2-1, 3-13, 3-27 
Display types, 2-1 

format display, 2-2, 3-11 

text display, 2-2, 3-10 

Echo, 2-3 

Editing, 3-13 to 3-19 

End a selection, 3-18 

Enter escape character, 3-48 

Enter today's date, 3-55 

Escape character, 2-5, 3-1, 3-48 

Escape sequence, 2-5, 3-1 to 3-56, B-1 to B-32 

communications: 

establishment and monitoring, 3-35 

information transfer, 3-41 

transmission type specification, 3-40 

X.25 Network Gateway, 3-36 

cursor control, 3-4 

display memory management, 3-50 

field: 

definition, 3-20 to 3-25 

verification, 3-29 
file management, 3-45 
format management, 3-20 
formats, 3-1 

delimiters, 3-2 
from a command file, 3-2 
from the host computer, 3-2 
from the keyboard, 3-2 
key association, 3-3 
look-up tables, 3-26 
margin control, 3-10 
miscellaneous, 3-53 
operation, 3-3 
printer management, 3-45 
programmable string manipulation, 3-31 
range tables, 3-28 
sorting, 3-52 
tab control, 3-10 
text scrolling, 3-9 
Executes field verification program, 3-30 

Field, 2-2, 4-3 
attributes, 2-2 

primary, 3-20, 3-23 

secondary, 3-20, 3-29 
characteristics: 

display, 2-2 

input. 2-2 
definition, 3-20, 4-10 
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protected. 2-2, 3-23 
unprotected, 2-2 
verification, 3-29 
Field verification program, 2-5, 3-3, 3-29, 4-1 
allocating space, 3-29 
arithmetic statements, 4-3, 4-4 

result, 4-4 
comment statements, 4-9 
comparisons 

arithmetic, 4-6 

special variable tests, 4-6, 4-7 

string comparisons, 4-6, 4-7 
current field, 4-10 
data items, 4-2 

accumulators, 4-2, 4-6 

constants, 4-3, 4-6 

fields, 4-3. 4-6 
error reporting. 4-10 
executing, 4-9 
keywords, 4-1 
labels, 4-5 
language, 4-1 
loading, 4-9 
put statements, 4-8 
return statements, 4-7 
transfer statements, 4-5 

conditional, 4-6 

unconditional, 4-5 
Files, 2-3 

command, 2-5 
input, 2-4. 3-47, 3-48 
output, 2-4, 3-48 
printer, 2-4, 3-49 
recording, 2-4, 3-48, 3-49 
Form, 2-2 
loading, 3-20 
field definition. 3-20 
Format Management, 3-20 
loading a form, 3-20 
field definition, 3-20 
escape sequences, 3-21 

Home down position, 3-7 
Home left position, 3-7 
Home position, 3-7 
Home right position, 3-8 

Information transfer, 3-41 to 3-45 

Keyboard. 2-4 
lock, 3-54 

programmable keys, 3-31 to 3-34 
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Loading the field verification program, 3-30 
Look-up tables, 3-26 

Margin control, 3-10 

text display. 3-10 to 3-13 
Mode. See Transmission type. 
Monitors for a host computer message, 3-44 
Moving the cursor: 

to first character position of current field, 3-12 

to first position of first unprotected field, 3-7 

to first unprotected field, 3-7 

to home down position, 3-7 

to home left positjon,3-7 

to home right position, 3-8 

to last nonblank column of current field, 3-8 

to next tab stop, 3-12 

to previous tab stop, 3-12 

down, 3-6 

left, 3-7 

right, 3-6 

up, 3-6 

to column in current line, 3-8 
to particular line, 3-8 

Overtype mode, 3-16 

Packet assembly/disassembly 

(PAD) facilities, 3-37 
Printer logging, 3-49 
Printing, 3-49 
Programmable strings, 3-31 

activating, 3-34 

appends a field to, 3-34 

appends text to, 3-34 

clears, 3-34 

escape sequences, 3-34 

function identification, 3-32 

processes when error occurs, 3-55 
Public data networks (PON), 3-36 

Reading an input file, 3-48 

Request for transmission of cursor position, 3-7 

Reset communications, 3-55 

Reset keyboard LEDs, 3-56 

Reset MTP, 3-55 

Return statements, 4-7 

Screen, 2-1 

Scrolling display memory, 3-9, 3-10 
Selection: 

beginning, 3-18 

copying, 3-19 

deleting, 3-18 
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ending a column selection, 3-17 

ending a text selection, 3-18 

moving, 3-18 
Set the keyboard LEDs, 3-56 
Sorting, 3-52 

ascending, 3-53 

descending, 3-53 
Status frame, 2-1 

Tab control, 3-10 

format display, 3-10 to 3-13 

text display, 3-10 to 3-13 
Tables 

look-up, 3-26 

range, 3-28 

Terminate MTP with specified error code, 3-36 
Text display. See Display types. 
Text scrolling, 3-9 
Transfer statements: 
conditional, 4-6 

arithmetic comparison, 4-6 
string comparison, 4-7 
special variable tests, 4-7 
unconditional, 4-5 
Transmission types, 2-3 
block, 2-3 

conversational transmission, 2-3 
full-duplex mode, 2-3 
half-duplex mode, 2-3 
specification, 3-40 
Transmit a break indication, 3-43 
Transmit a field, 3-43 

Transmit a file to host computer, 3-43, 3-47 
Unlocking the keyboard, 3-54 
Video display, 2-1 
Window, 2-1 

Writing to output file, 3-48 

Escape Sequences: 

ESC A, 3-6 
ESC B, 3-6 
ESC C, 3-6 
ESC D, 3-7 
ESC E, 3-16 
ESC F , 3-7 
ESC 6, 3-7 
ESC H, 3-7 
ESC I, 3-12 
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Escape Sequences: 

ESC J. 3-16 
ESC K, 3-16 
ESC I, 3-43 
ESC 3-16 
ESC N, 3-16 
ESC 0, 3-17 
ESC P, 3-43 
ESC R, 3-17 
ESC S , 3-9 
ESC T, 3-9 
ESC U, 3-10 
ESC V, 3-10 
ESC W, 3-22 
ESC X, 3-22 
ESC Y, 3-43, 3-47 
ESC a, 3-7 
ESC b, 3-54 
ESC c , 3-54 
ESC d, 3-43 
ESC e. 3-43 
ESC f, 3-17 
ESC g, 3-55 
ESC i, 3-12 
ESC i, 3-41 
ESC k, 3-41 
ESC I 3-18 
ESC m, 3-48 
ESC n, 3-8 
ESC 0, 3-48 
ESC p, 3-18 
ESC q, 3-18 
ESC r, 3-18 
ESC s, 3-19 
ESC t, 3-22 
ESC u, 3-48 
ESC V, 3-48 
ESC w, 3-41 
ESC X "text", 3-44 
ESC V, 3-48 
ESC 0, 3-19, 3-50 
ESC 1, 3-12 
ESC 2, 3-12 
ESC 3, 3-13 
ESC 5, 3-13 
ESC 6, 3-48 
ESC 7, 3-49 
ESC 8, 3-49 
ESC 9. 3-49 
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Escape Sequences: 

ESC -f-, 3-49 
ESC 3-49 
ESC 3-49 
ESC >, 3-53 
ESC <, 3-53 
ESC @ "text", 3-44 
ESC 3-55 
ESC *, 3-55 
ESC A, 3-55 
ESC %, 3-38 
ESC &, 3-38 
ESC \text\, 3-30 
ESC ? "text", 3-55 
ESC: 47 A, 3-44 
ESC: 47@ "text", 3-44 
ESC: 52A, 3-44 
ESC: 52® "text", 3-44 
ESC: 53A, 3-45 
ESC: 53@ "text^ 3-45 
ESC: 63A, 3-45 
ESC: 63@ "text", 3-45 
ESC: 64A, 3-39 
ESC: 64@ "text", 3-39 
ESC: 64>, 3-40 
ESC: 65A, 3-40 
ESC: 65@ "text", 3-40 
ESC: 65>, 3-40 
ESC:n ?, 3-34 
ESC:n @ "text", 3-34 
ESC:n >, 3-34 
ESC:n A, 3-34 
ESC:n B, 3-8 
ESC:n C, 3-8 
ESC:n F, 3-22 
ESC:n G, 3-22 
ESC:n H, 3-22 
ESC:n I, 3-22 
ESC:n J, 3-23 
ESC:n K, 3-55 
ESC:n L, 3-56 
ESC:n 0, 3-8 
ESC:n S, 3-27 
ESC:n T "string", 3-27 
ESC:n U, 3-29 
ESC:n V, 3-29, 
ESC:n W, 3-29 
ESC:n X, 3-30 
ESC:n Y, 3-25 
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Escape Sequences: 

ESC:n Z, 3-26 

ESC:n b, 3-39 
ESC:n d, 3-51 
ESC:n 3 56 
ESC:n h, 3-36 
ESC:n j, 3-51 
ESC:n k, 3-36 
ESC:n 1, 3-51 
ESCrn m, 3-36 
ESC:n n, 3-39 
ESC:n o, 3-39 
ESC:n q, 3-39 
ESC:n z, 3-52 

Key Index 

]. 3-6 
I 3-6 

3-6 

3-7 

BOUND, 3-18 
CANCEL, 3-54 
CODE-1, 3-7 
CODE-^, 3-7 
CODE-I, 3-7 
CODE--., 3-8 
CODE-BOUND, 3-17 
CODE-CANCEL, 3-55 
CODE-DELETE, 3-18 
CODE-FINiSH, 3-55 
CODE-MARK. 3-16 
CODE-TAB, 3-12 
CODE-a, 3-55 
CODE-c, 3-48 
CODE-d. 3-19, 3-50 
CODE-e, 3-12 
CODE-f, 3-12 
CGDE-g, 3-13 
COOE-i, 3-13 
CODE-z, 3-52 
CODE-8, 3-49 
CODE-9, 3-49 
C0DE-[, 3-53 
COOE-1. 3-53 
COPY, 3-19 
DELETE, 3-!I7 
MARK. 3-18 
MOVE. 3-18, 
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Key Index 

NEXT, 3-16 
NEXT PAGE. 3-10 
OVERTYPE (LED on). 3-16 
OVERTYPE (LED off), 3-17 
PREV PAGE, 3-10 
RETURN, 3-16 
SCROLL DOWN, 3-9 
SCROLL UP, 3-9 
SHIFT-CANCEL, 3-55 
SHIFT-DELETE, 3-16 
TAB, 3-12 
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